首页 > 代码库 > mysqli_stmt类：使用预处理语句处理SELECT查询结果
mysqli_stmt类：使用预处理语句处理SELECT查询结果
SELECT语句和其他的SQL查询命令不同，它需要处理查询结果。SQL语句的执行也需要使用mysqli_stmt对象中的execute()方法，但与mysqli对象中的query()方法不同，execute()方法的返回值并不是一个mysqli_result对象。mysqli_stmt对象提供了一种更为精巧的办法来处理SELECT语句查询结果：在使用execute()方法执行SQL语句完成查询之后，使用mysqli_stmt对象中的bind_result()方法，把查询结果的各个数据列绑定到一些PHP变量上；然后使用mysqli_stmt对象中的fetch()方法把下一条结果记录读取到这些变量里。如果成功地读入下一条记录fetch()方法返回TRUE，否则返回FALSE，或者已经读完所有的结果记录返回FALSE。
默认情况下，SELECT查询结果将留在MySQL服务器上，等待fetch()方法把记录逐条取回到PHP程序中，赋给使用bind_result()方法绑定的PHP变量上。如果需要对所有记录而不只是一小部分进行处理，可以调用mysqli_stmt对象中的store_result()方法，把所有结果一次全部传回到PHP程序中。这样做不仅更有效率，而且能减轻服务器的负担。store_result()方法是可选的，除了读取数据不改变任何东西。以联系人信息表contactinfo为例，使用预处理语句处理SELECT查询结果的代码如下所示：
<?php$mysqli = new mysqli("localhost", "mysql_user", "mysql_pwd", "demo"); // 连接MySQL数据库if (mysqli_connect_errno()){ // 检查连接错误 printf(“连接失败: %s<br>”, mysqli_connect_error()); exit();} $query = "SELECT `name`, `address`, `phone` FROM `contactinfo` LIMIT 0,3"; // 声明SELECT语句if ($stmt = $mysqli->prepare($query)){ // 处理打算执行的SQL命令 $stmt->execute(); // 执行SQL语句 $stmt->store_result(); // 取回全部查询结果 echo "记录个数：".$stmt->num_rows."行<br />"; // 输出查询的记录个数 $stmt->bind_result($name, $address, $phone); // 当查询结果绑定到变量中 while ($stmt->fetch()) { // 逐条从MySQL服务取数据 printf ("%s (%s,%s)<br />", $name, $address, $phone); //格式化结果输出 } $stmt->close(); //释放mysqli_stmt对象占用的资源} $mysqli->close();//关闭与MySQL数据库的连接?>
输出结果如下所示：
- 记录个数：3行
- 高某某 (海淀区,15801688338)
- 洛某某 (朝阳区,15801681234)
- 峰某某 (东城区,15801689876)
如果获取SELECT语句查找到了多少条记录，可以从mysqli_stmt对象中的num_rows属性中检索出来。但是，这个属性只有在提前执行过store_result()方法，将全部查询结果传回到PHP程序中的情况下才可以使用。
如果在SELECT语句中也使用占位符号（?），并需要多次执行这一条语句时，也可以将mysqli_stmt对象中的bind_param()和bind_result()方法结合起来使用。代码如下所示：
<?php$mysqli = new mysqli("localhost", "mysql_user", "mysql_pwd", "demo"); // 连接MySQL数据库if (mysqli_connect_errno()){ // 检查连接错误 printf("连接失败: %s<br>", mysqli_connect_error()); exit();} // 声明SELECT语句，按部门编号查找，使用占位符号（?）表示将要查找的部门$query = "SELECT `name`, `address`, `phone` FROM `contactinfo` WHERE `departmentId`=? LIMIT 0,3";if ($stmt = $mysqli->prepare($query)){ // 处理打算执行的SQL命令 $stmt->bind_param(‘s‘, $departmentId); // 绑定参数部门编号 $departmentId = "D01"; // 给绑定的变量赋上值 $stmt->execute(); // 执行SQL语句 $stmt->store_result(); // 取回全部查询结果 $stmt->bind_result($name, $address, $phone); // 当查询结果绑定到变量中 echo "D01部门的联系人信息列表如下：<br />"; // 打印提示信息 while ($stmt->fetch()) { // 逐条从MySQL服务取数据 printf ("%s (%s,%s)<br />", $name, $address, $phone); // 格式化结果输出 } echo "D02部门的联系人信息列表如下：<br />"; // 打印提示信息 $departmentId = "D02"; // 给绑定的变量赋上新值 $stmt->execute(); // 执行SQL语句 $stmt->store_result(); // 取回全部查询结果 while ($stmt->fetch()) { // 逐条从MySQL服务取数据 printf ("%s (%s,%s)<br />", $name, $address, $phone); //格式化结果输出 } $stmt->close(); // 释放mysqli_stmt对象占用的资源} $mysqli->close();// 关闭与MySQL数据库的连接?>
输出结果如下所示：
- D01部门的联系人信息列表如下：
- 高某某 (海淀区,15801688338)
- 陈某某 (昌平区,15801682468)
- 白某某 (海淀区,15801689675)
- D02部门的联系人信息列表如下：
- 洛某某 (朝阳区,15801681234)
在上面的示例中，根据提供的部门参数不同，从数据库中分别取出两个部门的联系人信息。只要使用一次bind_result()方法绑定结果就可以了，并不需要每次执行都把查询结果的各个数据列绑定到一些PHP变量上。
在生成网页时，许多PHP脚本通常都会执行除参数以外，其他部分完全相同的查询语句，针对这种重复执行一个查询，每次迭代使用不同的参数情况，MySQL从4.1版本开始提供了一种名为预处理语句（prepared statement）的机制。它可以将整个命令向MySQL服务器发送一次，以后只有参数发生变化，MySQL服务器只需对命令的结构做一次分析就够了。这不仅大大减少了需要传输的数据量，还提高了命令的处理效率。可以用mysqli扩展模式中提供的mysqli_stmt类的对象，去定义和执行参数化的SQL命令，mysqli_result类中包含的全部成员属性和成员方法如表13-6和表13-7所示。
表13-6 mysqli_stmt类中的成员方法（共12个）
成员方法名 | 描 述 |
| bind_param() | 该方法把预处理语句各有关参数绑定到一些PHP变量上，注意参数的先后顺序 |
| bind_result() | 预处理语句执行查询之后，利用该方法将变量绑定到所获取的字段 |
| close() | 一旦预处理语句使用结果之后，它所占用的资源可以通过该方法回收 |
| data_seek() | 在预处理语句中移动内部结果的指针 |
| execute() | 执行准备好的预处理语句 |
| fetch() | 获取预处理语句结果的每条记录，并将相应的字段赋给绑定结果 |
| free_result() | 回收由该对象指定的语句占用的内存 |
| result_metadata() | 从预处理中返回结果集原数据 |
| prepare() | 无论是绑定参数还是绑定结果，都需要使用该方法准备要执行的预处理语句 |
| send_long_data() | 发送数据块 |
| reset() | 重新设置预处理语句 |
| store_result() | 从预处理语句中获取结果集 |
表13-7 mysqli_stmt类中的成员属性（共6个）
成员属性名 | 描 述 |
| $affected_rows | 返回该对象指定的最后一条语句所影响的记录数。注意，该方法只与插入、修改和删除三种查询句有关 |
| $errno | 返回该对象指定最近所执行语句的错误代码 |
| $error | 返回该对象指定最近所执行语句的错误描述字符串 |
| $param_count | 返回给定的预处理语句中需要绑定的参数个数 |
| $sqlstate | 从先前的预处理语句中返回SQL状态错误代码 |
| $num_rows | 返回stmt对象指定的SELECT语句获取的记录数 |
mysqli_stmt类：使用预处理语句处理SELECT查询结果