(无版本信息可用,可能只在 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" } }