PHP中的MySQLi扩展学习（五）MySQLI_STMT对象操作 php

就像 PDO 中的 PDO_Statment 对象一样，MySQLI_STMT 对象也是一个预处理语句所形成的对象，专门用来操作 MySQLi 所生成的预处理语句的。其实操作方式之类也都比较相似，不外乎以绑定参数为主的一些针对 SQL 语句和获取结果集的操作。
参数绑定及操作属性之前的文章中想必大家已经见过我们使用的 bind_param() 方法，它与 PDO 中的 bindParam() 方法有很大的不同。

$stmt = $mysqli->prepare("insert into zyblog_test_user(username, password, salt) values(?, ?, ?)"); $username='mysqli_username'; $password='mysqli_password'; $salt = 'mysqli_salt'; $stmt->bind_param('sss', $username, $password, $salt); var_dump($stmt->insert_id); // int(232) var_dump($stmt->affected_rows); // int(1)$stmt->execute(); $stmt->close();

首先就是之前提到过的，MySQLI_STMT 中绑定参数只能使用 ? 问号占位符，然后在使用 bind_param() 时，使用的是 's' 这种来按顺序绑定参数，这个 's' 代表的就是字符串。另外还可以是 'i' 表示整型数字、'd' 表示浮点数字、 'b' 表示 blob 类型。
另外，从上面的测试代码中还可以看出，可以使用一个 bind_param() 方法绑定多个参数，'sss' 就是三个字符串，按顺序进行绑定。
绑定参数之后，我们就可以通过 execute() 方法来执行语句。同 PDO 一样，这个方法只返回成功失败的信息，也就是一个布尔值。所以，我们需要通过 MySQLI_STMT 对象的 insert_id 来获得新增加数据的 ID ，或者通过 affected_rows 属性来获得当前语句执行后影响的行数，来确定语句是否真正地执行完成并达到我们的期望。
最后，我们使用 close() 关闭一个当前的 STMT 对象。这样在后面的操作中上面的 $stmt 对象就无法使用了。
接下来，我们看看如果绑定了错误的类型会怎么样，以及 MySQLI_STMT 中关于错误信息的提示。

$stmt = $mysqli->prepare("insert into zyblog_test_user(id, username, password, salt) values(?, ?, ?, ?)"); $id = 's'; $username='mysqli_username'; $password='mysqli_password'; $salt = 'mysqli_salt'; $stmt->bind_param('isss', $username, $password, $salt); $stmt->execute(); var_dump($stmt->errno); // int(2031) var_dump($stmt->error); // string(53) "No data supplied for parameters in prepared statement" var_dump($stmt->error_list); // array(1) { //[0]=> //array(3) { //["errno"]=> //int(2031) //["sqlstate"]=> //string(5) "HY000" //["error"]=> //string(53) "No data supplied for parameters in prepared statement" //} //}$stmt->close();

在代码中，我们增加了 id 参数的绑定，然后指定的类型是 'i' ，但是，我们实际传递的变量是一个字符串类型，结果就会导致 MySQLI_STMT 产生错误。
可以看出，MySQLI_STMT 的错误属性和信息基本和 MySQLi 对象的是一样的。
列绑定除了请求查询语句参数的绑定之外，MySQLI_STMT 也是支持直接绑定列的。就和 PDO 中的 bindColumn() 一样。

$stmt = $mysqli->prepare("select * from zyblog_test_user where username = ?"); $username = 'kkk'; $stmt->bind_param("s", $username); // 绑定参数 $stmt->bind_result($col1, $col2, $col3, $col4); $stmt->execute(); // 执行语句var_dump($stmt); // object(mysqli_stmt)#2 (10) { //["affected_rows"]=> //int(-1) //["insert_id"]=> //int(0) //["num_rows"]=> //int(0) //["param_count"]=> //int(1) //["field_count"]=> //int(4) //["errno"]=> //int(0) //["error"]=> //string(0) "" //["error_list"]=> //array(0) { //} //["sqlstate"]=> //string(5) "00000" //["id"]=> //int(3) //}while($stmt->fetch()){ printf("%s %s %s %s", $col1, $col2, $col3, $col4); echo PHP_EOL; } // 42 kkk 666 k6 // 43 kkk 666 k6 // ……var_dump($stmt->num_rows); // int(7)$stmt->close();

当然，方法的名称还是有些变动的。MySQLI_STMT 中绑定列的方法名为 bind_result() ，虽说名字不一样，但功能其实都是差不多的，查询语句中是几个列名，就要绑定几个列名。在这个表中，我们有四个字段，所以通过引用传递的方式绑定了 4 个列变量。当使用 fetch() 进行查询结果对象的遍历时，就像使用引用的方式为这 4 个列变量赋值。
在这段代码中，我们使用了 num_rows 这个属性来获得查询结果的行数量，这个属性是只针对 SELECT 语句的。上面介绍过的 affected_rows 是受影响的行数，这两个属性不是相同的概念哦！
返回结果集执行 fetch() 方法返回的是一个布尔值，它主要的作用是将结果集绑定到指定的变量中，所以如果你直接打印它的结果是不会有什么有用的信息的，我们必须通过绑定列变量的方式来获得数据。而真正获得结果集的数据其实是通过另一个方法来获得一个 MySQLI_result 对象，然后再使用这个对象里面的方法就可以像 PDO 的 fetch() 一样来获得真正的结果集了。

$stmt = $mysqli->prepare("select * from zyblog_test_user where username = 'kkk'"); $stmt->execute(); // 执行语句 $result = $stmt->get_result(); while($row = $result->fetch_assoc()){ var_dump($row); } // array(4) { //["id"]=> //int(42) //["username"]=> //string(3) "kkk" //["password"]=> //string(3) "666" //["salt"]=> //string(2) "k6" //} // ……$stmt->close();

在这里，我们通过 get_result() 方法获得了一个结果集的 MySQLI_result 对象。然后通过该对象的 fetch_assoc() 就获得了键名形式的结果集数组。
关于 MySQLI_result 对象的内容，我们将在下篇文章中再进行详细的学习了解。
保存结果集及游标移动最后就是关于游标的移动，上面的测试数据中我们可以查询到 7 条数据，并且第一条数据的 id 是 42 ，通过游标，我们可以不在 SQL 语句中使用 limit 而直接操作结果集来获取需要的数据。

$stmt = $mysqli->prepare("select * from zyblog_test_user where username = 'kkk'"); $stmt->bind_result($col1, $col2, $col3, $col4); $stmt->execute(); // 执行语句 $stmt->store_result(); // 一共7条，从第5个开始 $stmt->data_seek(5); $stmt->fetch(); printf("%s %s %s %s", $col1, $col2, $col3, $col4); // 47 kkk 666 k6 echo PHP_EOL; $stmt->close();

首先，我们需要使用 store_result() 方法来将结果集保存到内存中，这个方法和 MySQLi 中的 store_result() 方法是一样的。然后，通过 data_seek() 方法将游标移动 5 个位置，最后输出的结果就是后面那两条数据的内容了。是不是很高大上的感觉！
总结关于 MySQLI_STMT 对象的内容还有一些，不过就不是那么常用了。从我们讲解的这些内容也可以看出它和 PDO 的许多不同之处。当然，总体的大方向基本还是一致的，所以我们学习起来也并不会有太大的困难，掌握理解之后更多的还是要动手操作，基本功可千万不能荒废哦！
测试代码：
https://github.com/zhangyue0503/dev-blog/blob/master/php/202009/source/8.PHP中的MySQLi扩展学习（五）MySQLI_STMT对象操作.php
参考文档：
https://www.php.net/manual/zh/book.mysqli.php 【PHP中的MySQLi扩展学习（五）MySQLI_STMT对象操作】各自媒体平台均可搜索【硬核项目经理】