PHP 動態綁定變量到 Prepared Statement 完整實作

應用場景

當 SQL 參數數量不固定（如動態 WHERE 條件、批次 INSERT）時，需將陣列參數動態綁定至 mysqli_stmt::bind_param。由於 bind_param 需傳入實際變量引用而非值，需用變量變量技巧構建引用陣列。

核心實作

private function bindVars($stmt, $params) {
    if ($params != null) {
        // 1. 建立型別字串：i=integer, d=double, s=string, b=blob
        $types = '';
        foreach ($params as $param) {
            if (is_int($param)) $types .= 'i';
            elseif (is_float($param)) $types .= 'd';
            elseif (is_string($param)) $types .= 's';
            else $types .= 'b';
        }
        
        // 2. 第一個元素為型別字串
        $bind_names[] = $types;
        
        // 3. 為每個參數建立變量變量引用
        for ($i = 0; $i < count($params); $i++) {
            $bind_name = 'bind' . $i;        // 變量名：bind0, bind1...
            $$bind_name = $params[$i];       // 變量變量賦值
            $bind_names[] = &$$bind_name;    // 存入引用
        }
        
        // 4. 動態呼叫 bind_param
        call_user_func_array(array($stmt, 'bind_param'), $bind_names);
    }
    return $stmt;
}

使用範例

$mysqli = new mysqli("localhost", "user", "pass", "db");
$sql = "SELECT * FROM users WHERE status = ? AND role IN (?, ?) AND created_at > ?";
$stmt = $mysqli->prepare($sql);

// 動態參數陣列
$params = array(1, 'admin', 'editor', '2023-01-01');

// 綁定並執行
$this->bindVars($stmt, $params);
$stmt->execute();
$result = $stmt->get_result();
while ($row = $result->fetch_assoc()) {
    print_r($row);
}

原理解析

現代替代方案

PHP 8.1+ : mysqli_execute_query (內建支援陣列參數)

$mysqli = new mysqli("localhost", "user", "pass", "db");
$params = [1, 'admin', 'editor', '2023-01-01'];
$result = $mysqli->execute_query("SELECT * FROM users WHERE status = ? AND role IN (?, ?) AND created_at > ?", $params);
foreach ($result as $row) print_r($row);

PDO (早已支援陣列直接執行)

$pdo = new PDO("mysql:host=localhost;dbname=db;charset=utf8", "user", "pass");
$params = [1, 'admin', 'editor', '2023-01-01'];
$stmt = $pdo->prepare("SELECT * FROM users WHERE status = ? AND role IN (?, ?) AND created_at > ?");
$stmt->execute($params);
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) print_r($row);

適用場景建議

• 舊專案維護：僅能用 mysqli 舊版 API 時使用此技巧
• 新專案開發：優先選擇 PDO 或 PHP 8.1+ mysqli 新 API
• 框架開發：封裝於 Query Builder 內部，對上層隱藏複雜度

此技巧展示了 PHP 變量變量與引用機制的進階應用，理解其原理有助於深入掌握 PHP 內部運作。