PHP如何使用MySQLi中的MySQLI_result物件操作

在之前我們就已經接觸過MYSQLI_result相關的內容。它其實就是一個查詢的結果集。不過在PDO中，一般透過query()或PDOStatement物件查詢後就會回傳結果。但在MySQLi中，會把查詢到的結果也放入一個物件中，這就是MySQLI_result物件。

MySQLI_result 物件屬性

首先，我們要透過一段查詢來取得一個 MySQLI_result 物件。

$stmt = $mysqli->prepare("select * from zyblog_test_user where username = 'kkk'");

$stmt->execute(); // 执行语句
$result = $stmt->get_result();
var_dump($result);
// object(mysqli_result)#3 (5) {
//     ["current_field"]=>
//     int(0)
//     ["field_count"]=>
//     int(4)
//     ["lengths"]=>
//     NULL
//     ["num_rows"]=>
//     int(7)
//     ["type"]=>
//     int(0)
//   }

如果使用的 MYSQLI_STMT 的話，直接在 execute() 方法執行查詢語句之後，就可以透過 get_result() 方法取得一個 MySQLI_result 物件。

在這個物件中，我們可以看到有 current_field 目前欄位 、 field_count 欄位數量 、 lengths 欄位長度 、 num_rows 行數 、 type 這些屬性內容。不少同學會發現，current_field 和lengths 好像沒有什麼實際的內容，其實這兩個屬性是需要在特定操作下才會顯示內容的，比如lengths 是要在fetch() 結果集之後才會有訊息的。

$result->fetch_array();
var_dump($result);
// ……
// ……
// ["lengths"]=>
//   array(4) {
//     [0]=>
//     int(0)
//     [1]=>
//     int(3)
//     [2]=>
//     int(3)
//     [3]=>
//     int(2)
//   }
// ……
// ……

而 current_field 屬性的內容我們將在下面遍歷查看字段資訊的時候再展示它的內容。

查詢結果集取得

MySQLI_result 物件的可見屬性中，我們只能看到上面的那些資訊。對於我們的業務開發來說其實用處不大，除了num_rows 可以用來根據行數判斷查詢是否有結果之外，更重要的是我們要獲取到結果集中的數據信息，這時就需要使用其它的函數來進行數據的獲取了。

取得全部結果集

var_dump($result->fetch_all());
// array(7) {
//     [0]=>
//     array(4) {
//       [0]=>
//       int(42)
//       [1]=>
//       string(3) "kkk"
//       [2]=>
//       string(3) "666"
//       [3]=>
//       string(2) "k6"
//     }
//     ……
//     ……



$result->data_seek(0);
var_dump($result->fetch_all(MYSQLI_ASSOC));
// array(7) {
//     [0]=>
//     array(4) {
//       ["id"]=>
//       int(42)
//       ["username"]=>
//       string(3) "kkk"
//       ["password"]=>
//       string(3) "666"
//       ["salt"]=>
//       string(2) "k6"
//     }
//     ……
//     ……

fetch_all() 方法就是用來取得全部的資料集內的數據，並以數組的形式返回，它可以指定返回的格式，預設情況下是MYSQLI_NUM 這種陣列下標的形式，和PDO 類似，我們直接指定為MySQLI_ASSOC 就可以傳回鍵名形式的資料內容。

data_seek() 方法是移動結果集的下標。當我們取得或使用後面要介紹的方法循環遍歷完成一次結果集之後，再次遍歷的話它的遊標已經處於最後一位的，這樣是無法獲取資料的。在上面的程式碼中，我們就是將遊標兩次回到 0 下標的位置，也就是最初始的位置，這樣我們就可以重複地操作這一個結果集了。

取得普通結果集

如果要一行一行資料的獲取，我們就可以使用各種形式的結果集資料取得方式。

var_dump($result->fetch_array());
// array(8) {
//     [0]=>
//     int(42)
//     ["id"]=>
//     int(42)
//     [1]=>
//     string(3) "kkk"
//     ["username"]=>
//     string(3) "kkk"
//     [2]=>
//     string(3) "666"
//     ["password"]=>
//     string(3) "666"
//     [3]=>
//     string(2) "k6"
//     ["salt"]=>
//     string(2) "k6"
//   }

var_dump($result->fetch_array(MYSQLI_ASSOC));
// array(4) {
//     ["id"]=>
//     int(43)
//     ["username"]=>
//     string(3) "kkk"
//     ["password"]=>
//     string(3) "666"
//     ["salt"]=>
//     string(2) "k6"
//   }

使用fetch_array() 就是獲取下一行的結果資料並以數組的形式返回，同樣它也可以指定返回結果集的格式，和fetch_all() 是類似的，只不過它是只獲取下一行而不是全部的資料集，而且它的參數預設是傳回的MYSQLI_BOTH ，也就是數字下標和鍵名下標同時回傳結果。

另外還有一個 fetch_assoc() 方法，直接就是傳回 MYSQLI_ASSOC 格式的數據，這個方法不需要任何參數，它可以看成是 fetch_array(MYSQLI_ASSOC) 這種使用方式的一個封裝。

var_dump($result->fetch_assoc());
// array(4) {
//     ["id"]=>
//     int(42)
//     ["username"]=>
//     string(3) "kkk"
//     ["password"]=>
//     string(3) "666"
//     ["salt"]=>
//     string(2) "k6"
//   }

而另一個方法 fetch_row() ，則可以看成是和 fetch_array(MYSQLI_NUM) 相似的一個方法。它其實就是預設指定為 MySQLI_NUM 的結構回傳方式。

var_dump($result->fetch_row());
// array(4) {
//     [0]=>
//     int(43)
//     [1]=>
//     string(3) "kkk"
//     [2]=>
//     string(3) "666"
//     [3]=>
//     string(2) "k6"
//   }

取得物件結果集

取得物件結果集其實和 PDO 中的相關功能也是類似的，它就是將結果直接放到一個類別中，並實例化回傳一個物件。

ar_dump($result->fetch_object());
// object(stdClass)#4 (4) {
//     ["id"]=>
//     int(42)
//     ["username"]=>
//     string(3) "kkk"
//     ["password"]=>
//     string(3) "666"
//     ["salt"]=>
//     string(2) "k6"
//   }

在這裡我們沒有指定類，所以它使用的是 stdClass 來傳回的物件結構。我們也可以指定一個類，並且可以為這個類別的建構子傳遞參數，這一點也和 PDO 中的相關函數一樣。

class User
{
    public function __construct()
    {
        print_r(func_get_args());
    }
}
var_dump($result->fetch_object('User', [1, 2, 3]));
// Array
// (
//     [0] => 1
//     [1] => 2
//     [2] => 3
// )
// object(User)#4 (4) {
//     ["id"]=>
//     int(42)
//     ["username"]=>
//     string(3) "kkk"
//     ["password"]=>
//     string(3) "666"
//     ["salt"]=>
//     string(2) "k6"
//   }

查詢結果集欄位資訊取得

接下來我們再看看 MySQLI_result 物件中的欄位相關資訊的取得。我們可以直接取得到目前查詢的結果集中的所有欄位資訊。

while ($finfo = $result->fetch_field()) {
    var_dump($result->current_field);
    var_dump($finfo);
}
// int(1)
// object(stdClass)#4 (13) {
//     ["name"]=>
//     string(2) "id"
//     ["orgname"]=>
//     string(2) "id"
//     ["table"]=>
//     string(16) "zyblog_test_user"
//     ["orgtable"]=>
//     string(16) "zyblog_test_user"
//     ["def"]=>
//     string(0) ""
//     ["db"]=>
//     string(9) "blog_test"
//     ["catalog"]=>
//     string(3) "def"
//     ["max_length"]=>
//     int(0)
//     ["length"]=>
//     int(11)
//     ["charsetnr"]=>
//     int(63)
//     ["flags"]=>
//     int(49667)
//     ["type"]=>
//     int(3)
//     ["decimals"]=>
//     int(0)
//   }
// int(2)
//   object(stdClass)#5 (13) {
//     ["name"]=>
//     string(8) "username"
//     ["orgname"]=>
//     string(8) "username"
//     ……
//     ……

在這段程式碼中，我們查看了 MySQLI_result 物件的 current_field 屬性訊息，可以看出，它指出的就是目前位於哪個欄位的下標。

欄位的資訊非常詳細，這些屬性的鍵名也很直觀，這裡就不作詳細的說明了。

$result->field_seek(1);
while ($finfo = $result->fetch_field()) {
    var_dump($finfo);
}
// object(stdClass)#5 (13) {
//     ["name"]=>
//     string(8) "username"
//     ["orgname"]=>
//     string(8) "username"

我們同樣也可以透過 field_seek() 方法來移動欄位遍歷的遊標。在這裡我們將遊標移到 1 ，就會從第二個 username 欄位開始遍歷。

var_dump($result->fetch_fields());
// array(4) {
//     [0]=>
//     object(stdClass)#5 (13) {
//       ["name"]=>
//       string(2) "id"
//       ["orgname"]=>
//       string(2) "id"
//       ["table"]=>
//       string(16) "zyblog_test_user"
//       ["orgtable"]=>
//       string(16) "zyblog_test_user"
//       ["def"]=>
//       string(0) ""
//       ["db"]=>
//       string(9) "blog_test"
//       ["catalog"]=>
//       string(3) "def"
//       ["max_length"]=>
//       int(0)
//       ["length"]=>
//       int(11)
//       ["charsetnr"]=>
//       int(63)
//       ["flags"]=>
//       int(49667)
//       ["type"]=>
//       int(3)
//       ["decimals"]=>
//       int(0)
//     }
//     [1]=>
//     object(stdClass)#4 (13) {
//       ["name"]=>
//       string(8) "username"

var_dump($result->fetch_field_direct(2));
// object(stdClass)#7 (13) {
//     ["name"]=>
//     string(8) "password"
//     ["orgname"]=>
//     string(8) "password"
//     ["table"]=>
//     string(16) "zyblog_test_user"
//     ["orgtable"]=>
//     string(16) "zyblog_test_user"
//     ["def"]=>
//     string(0) ""
//     ["db"]=>
//     string(9) "blog_test"
//     ["catalog"]=>
//     string(3) "def"
//     ["max_length"]=>
//     int(3)
//     ["length"]=>
//     int(765)
//     ["charsetnr"]=>
//     int(33)
//     ["flags"]=>
//     int(0)
//     ["type"]=>
//     int(253)
//     ["decimals"]=>
//     int(0)
//   }

fetch_fields() 方法和 fetch_all() 是類似的，它就是要取得全部的欄位資訊。而 fetch_field_direct() 則是根據參數來取得指定下標的欄位資訊。

总结

至此，MySQLi 相关扩展的学习我们也就告一段落了，其它的一些类和函数比如 MySQLI_Driver 、 MySQLI_Exception 之类的内容大家可以自行查阅相关的文档，内容都不是很多。MySQLI_Driver 对象可以帮助我们指定当前驱动的报错形式，之前的文章中我们也已经接触过。

总体来说，整个 PHP 中和 MySQL 打交道的官方扩展我们就已经全部学习完了，PDO 和 MYSQLi 这两个扩展大家更主要的还是要掌握它们的区别和联系。在实际的业务开发中 PDO 还是会使用得更多，但 MySQLi 也绝不是能够完全忽略的，多多动手尝试学习吧。

测试代码：

https://github.com/zhangyue0503/dev-blog/blob/master/php/202009/source/9.PHP中的MySQLi扩展学习（六）MySQLI_result对象操作.php

推荐学习：php视频教程

以上是PHP如何使用MySQLi中的MySQLI_result物件操作的詳細內容。更多資訊請關注PHP中文網其他相關文章！