请注意，这也适用于使用“?”标记的位置占位符
<?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一个 string（用于命名参数）或一个 int（用于位置参数），标识要绑定值的语句变量。如果命名参数没有以冒号 (:) 或 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 的类型自动检测：bool 和 int 将被视为 SQLITE3_INTEGER，float 将被视为 SQLITE3_FLOAT，null 将被视为 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('参数类型无效: '.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('参数类型无效: '.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("无法绑定参数: $val");
}
}
?>