(无版本信息可用,可能仅在 Git 中)
CollectionFind::bind — 将值绑定到查询占位符
它允许用户将参数绑定到 find 操作搜索条件中的占位符。占位符采用 :NAME 的形式,其中 ':' 是一个常见的占位符前缀,必须始终存在于任何 NAME 之前,NAME 是占位符的实际名称。如果搜索条件中必须替换多个实体,则 bind 函数接受占位符列表。
placeholder_values
在搜索条件中替换的值;允许多个值,并作为数组传递,其中“PLACEHOLDER_NAME => PLACEHOLDER_VALUE”。
一个 CollectionFind 对象,或者与 execute() 一起使用以返回一个 Result 对象。
示例 #1 mysql_xdevapi\CollectionFind::bind() 示例
<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");
$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();
$schema = $session->getSchema("addressbook");
$create = $schema->createCollection("people");
$result = $create
->add('{"name": "Alfred", "age": 18, "job": "Butler"}')
->execute();
// ...
$collection = $schema->getCollection("people");
$result = $collection
->find('job like :job and age > :age')
->bind(['job' => 'Butler', 'age' => 16])
->execute();
var_dump($result->fetchAll());
?>
以上示例将输出类似以下内容
array(1) { [0]=> array(4) { ["_id"]=> string(28) "00005b6b536100000000000000cf" ["age"]=> int(18) ["job"]=> string(6) "Butler" ["name"]=> string(6) "Alfred" } }