PHP中的MySQLi扩展学习(五)MySQLI_STMT对象操作

就像 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)