请注意，这也适用于使用“？”标记的位置占位符。
<?php
$stmt = $db->prepare('SELECT * FROM mytable WHERE foo = ? AND bar = ?');
$stmt->bindValue(1, 'somestring', SQLITE3_TEXT);
$stmt->bindValue(2, 42, SQLITE3_INTEGER);
?>
位置编号从 1 开始。
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
SQLite3Stmt::bindValue — 将参数的值绑定到语句变量
param可以是 字符串（用于命名参数）或 整数（用于位置参数），用于标识应将值绑定到的语句变量。如果命名参数不以冒号 (:) 或 at 符号 (@) 开头，则会自动在其前面添加冒号 (:)。位置参数以 1 开头。
value要绑定到语句变量的值。
type要绑定的值的數據類型。
SQLITE3_INTEGER：该值为带符号整数，存储在 1、2、3、4、6 或 8 字节中，具体取决于值的范围。
SQLITE3_FLOAT：该值为浮点数，存储为 8 字节 IEEE 浮点数。
SQLITE3_TEXT：该值为文本字符串，使用数据库编码（UTF-8、UTF-16BE 或 UTF-16-LE）存储。
SQLITE3_BLOB：该值为数据块，按原样存储。
SQLITE3_NULL：该值为 NULL 值。
从 PHP 7.0.7 开始，如果省略了 type，则会根据 value 的类型自动检测：布尔值 和 整数 被视为 SQLITE3_INTEGER，浮点数 视为 SQLITE3_FLOAT，空 视为 SQLITE3_NULL，其他所有类型均视为 SQLITE3_TEXT。以前，如果省略了 type，则默认为 SQLITE3_TEXT。
注意:
如果
value为null，则始终将其视为SQLITE3_NULL，而不管给定的type是什么。
| 版本 | 描述 |
|---|---|
| 7.4.0 |
param 现在也支持 @param 表示法。 |
范例 #1 SQLite3Stmt::bindValue() 范例
<?php
$db = new SQLite3(':memory:');
$db->exec('CREATE TABLE foo (id INTEGER, bar STRING)');
$db->exec("INSERT INTO foo (id, bar) VALUES (1, 'This is a test')");
$stmt = $db->prepare('SELECT bar FROM foo WHERE id=:id');
$stmt->bindValue(':id', 1, SQLITE3_INTEGER);
$result = $stmt->execute();
var_dump($result->fetchArray(SQLITE3_ASSOC));
?>以上示例将输出
array(1) {
["bar"]=>
string(14) "This is a test"
}
请注意，这也适用于使用“？”标记的位置占位符。
<?php
$stmt = $db->prepare('SELECT * FROM mytable WHERE foo = ? AND bar = ?');
$stmt->bindValue(1, 'somestring', SQLITE3_TEXT);
$stmt->bindValue(2, 42, SQLITE3_INTEGER);
?>
位置编号从 1 开始。手动为 bindValue 提供变量类型可能是个好主意，否则你可能会遇到奇怪的问题，因为传递的值通常被视为 SQLITE3_TEXT，导致查询出现错误。
例如
<?php
$st = $db->prepare('SELECT * FROM test WHERE (a+1) = ?');
$st->bindValue(1, 2);
?>
永远不会返回任何结果，因为 SQLite 将其视为查询 'SELECT * FROM test WHERE (a+1) = "2"'。你需要手动设置类型
<?php
$st = $db->prepare('SELECT * FROM test WHERE (a+1) = ?');
$st->bindValue(1, 2, \SQLITE3_INTEGER);
?>
这样就可以正常工作了。此错误已在 https://bugs.php.net/bug.php?id=68849 中报告
以下是一个简单的函数，可以帮助你使 bindValue 正确工作
<?php
function getArgType($arg)
{
switch (gettype($arg))
{
case 'double': return SQLITE3_FLOAT;
case 'integer': return SQLITE3_INTEGER;
case 'boolean': return SQLITE3_INTEGER;
case 'NULL': return SQLITE3_NULL;
case 'string': return SQLITE3_TEXT;
default:
throw new \InvalidArgumentException('Argument is of invalid type '.gettype($arg));
}
}
?>我使用了以下逻辑来准备语句，它处理值和数组（参考 bohwaz 的注释）
<?php
function getArgType($arg) {
switch (gettype($arg)) {
case 'double': return SQLITE3_FLOAT;
case 'integer': return SQLITE3_INTEGER;
case 'boolean': return SQLITE3_INTEGER;
case 'NULL': return SQLITE3_NULL;
case 'string': return SQLITE3_TEXT;
default:
throw new \InvalidArgumentException('Argument is of invalid type '.gettype($arg));
}
}
foreach ($params as $index => $val) {
// Sqlite 语句中的索引从 1 开始
if (is_array($val)) {
$ok = $stmt->bindParam($index + 1, $val);
} else {
$ok = $stmt->bindValue($index + 1, $val, getArgType($val));
}
if (!$ok) {
throw new Exception("Unable to bind param: $val");
}
}
?>