請注意，這也適用於使用 '?' 符號的位置佔位符
<?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 的類型自動偵測：bool 和 int 會被視為 SQLITE3_INTEGER，float 會被視為 SQLITE3_FLOAT，null 會被視為 SQLITE3_NULL，其他所有類型都會被視為 SQLITE3_TEXT。在舊版中，如果省略 type，則預設為 SQLITE3_TEXT。
注意事項:
如果
value為null，則無論指定的type為何，一律會將其視為SQLITE3_NULL。
| 版本 | 說明 |
|---|---|
| 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
函式 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");
}
}
?>