PHP 5.6.22 is available

mysqli_result::fetch_all

mysqli_fetch_all

(PHP 5 >= 5.3.0, PHP 7)

mysqli_result::fetch_all -- mysqli_fetch_all結果のすべての行を連想配列・数値添字配列あるいはその両方の形式で取得する

説明

オブジェクト指向型

mixed mysqli_result::fetch_all ([ int $resulttype = MYSQLI_NUM ] )

手続き型

mixed mysqli_fetch_all ( mysqli_result $result [, int $resulttype = MYSQLI_NUM ] )

mysqli_fetch_all() は、 すべての結果の行を取得してその結果セットを連想配列・数値添字配列あるいはその両方で返します。

パラメータ

result

手続き型のみ: mysqli_query()mysqli_store_result() あるいは mysqli_use_result() が返す結果セット ID。

resulttype

このオプションは、 結果の行データから返す配列の型を指定します。ここで指定可能な値は 定数 MYSQLI_ASSOCMYSQLI_NUM あるいは MYSQLI_BOTH. のいずれかです。

返り値

結果の行を含む連想配列あるいは数値添字配列の配列を返します。

MySQL ネイティブドライバ限定

mysqlnd でのみ使用可能です。

mysqli_fetch_all() は、すべての行を配列にまとめて一括で返します。 そのため、mysqli_fetch_array() のように結果セットから一行ずつ返す同等の関数に比べるとメモリの消費量が多くなる可能性があります。 また、結果セットを順に処理していく際にはループ構造が必要となり、 さらにパフォーマンスに影響を及ぼすでしょう。これらを考慮すると、 mysqli_fetch_all() を使うのは 結果セットを別のレイヤーに渡して処理させるなどの特別な場合に限定しなければなりません。

参考

  • mysqli_fetch_array() - 結果の行を連想配列・数値添字配列あるいはその両方の形式で取得する
  • mysqli_query() - データベース上でクエリを実行する

add a note add a note

User Contributed Notes 6 notes

up
30
jcastro at eftec dot cl
1 year ago
I tested using "fetch all" versus "while / fetch array" and :

fetch-all uses less memory (but not for so much).

In my case (test1 and test2): 147008,262848 bytes (fetch-all) versus 147112,262888 bytes (fetch-array & while.

So, about the memory, in both cases are the same.

However, about the performance
My test takes :350ms (worst case) using fetch-all, while it takes 464ms (worst case) using fetch-array, or about 35% worst using fetch array and a while cycle.

So, using fetch-all, for a normal code that returns a moderate amount of information is :
a) cleaner (a single line of code)
b) uses less memory (about 0.01% less)
c) faster.

php 5.6 32bits, windows 8.1 64bits
up
14
m dot amiot at otak-arts dot com
4 years ago
If you really need this function, you can just extend the mysqli_result class with a function like this one.

<?php
       
public function fetch_all($resulttype = MYSQLI_NUM)
        {
            if (
method_exists('mysqli_result', 'fetch_all')) # Compatibility layer with PHP < 5.3
               
$res = parent::fetch_all($resulttype);
            else
                for (
$res = array(); $tmp = $this->fetch_array($resulttype);) $res[] = $tmp;

            return
$res;
        }
?>
up
0
cybernet678 at yahoo dot com
10 days ago
It should be noted that this function only works with the mysqlnd package.

With that being said mysqlnd has proven to be very unstable, from experience, which may end up cause php to segfault, unexpectedly.

If you are getting segfaults, you should try using some other mysql package and use mysqli_fetch_row instead.
up
0
andrey at php dot net
5 years ago
Return value changed in 5.3.3 - between 5.3.0 and 5.3.2 (incl.) when the result set was empty NULL was returned. 5.3.3+ returns an empty array.
Also, mysqli_fetch_all works only for buffered result sets, which are the default for mysqli_query. MYSQLI_USE_RESULT will be supported in 5.3.4+
However, it makes little sense to use it this way, materialising unbuffered sets. In this case choose STORE_RESULT, and fetch_all won't copy the data, but reference it, as it is stored already in mysqlnd.
up
-15
windix at gmail dot com
5 years ago
If you get an empty set after calling fetch_all(), make sure the result set cursor is reset to the beginning
up
-28
kevin at metalaxe dot com
7 years ago
If you are getting the following error:

Fatal error: Call to undefined method mysqli_result::fetch_all()

Be sure you didn't miss this line after the procedural call about it requiring mysqlnd
To Top