前言
mysqli 預處理語句 (Prepared Statements) 是防止 SQL 注入、提升重複執行效能的核心手段。本文示範完整流程:連接、準備、綁定參數、執行、錯誤處理、批次插入。
基礎插入流程
<?php
$mysqli = new mysqli('localhost', 'user', 'pass', 'dbname');
if ($mysqli->connect_errno) {
die('連接失敗: ' . $mysqli->connect_error);
}
$mysqli->set_charset('utf8mb4');
// 1. 準備語句 (佔位符 ?)
$stmt = $mysqli->prepare('INSERT INTO users (username, email, created_at) VALUES (?, ?, NOW())');
if (!$stmt) {
die('Prepare 失敗: ' . $mysqli->error);
}
// 2. 綁定參數 (類型字串: s=string, i=integer, d=double, b=blob)
$username = 'john_doe';
$email = 'john@example.com';
$stmt->bind_param('ss', $username, $email);
// 3. 執行
if ($stmt->execute()) {
echo "插入成功,自增 ID: " . $stmt->insert_id;
} else {
echo "執行失敗: " . $stmt->error;
}
$stmt->close();
$mysqli->close();
?>
批次插入 (高效能)
<?php
$users = [
['alice', 'alice@example.com'],
['bob', 'bob@example.com'],
['charlie', 'charlie@example.com'],
];
$stmt = $mysqli->prepare('INSERT INTO users (username, email) VALUES (?, ?)');
$stmt->bind_param('ss', $username, $email);
$mysqli->begin_transaction();
try {
foreach ($users as $user) {
[$username, $email] = $user;
$stmt->execute();
}
$mysqli->commit();
echo "批次插入 " . count($users) . " 筆成功";
} catch (Exception $e) {
$mysqli->rollback();
echo "回滾: " . $e->getMessage();
}
$stmt->close();
?>
參數類型對照表
| 類型字元 | PHP 類型 | MySQL 類型範例 |
| i | integer | INT, TINYINT, BIGINT |
| d | float/double | FLOAT, DOUBLE, DECIMAL |
| s | string | VARCHAR, TEXT, DATE, DATETIME, JSON |
| b | string (binary) | BLOB, VARBINARY |
常見錯誤與排查
- bind_param 參數數量不匹配:檢查
? 數量與變數個數、類型字串長度。
- 變數引用問題:
bind_param 需傳變數引用,不能直接傳值或表達式 (如 bind_param('s', $a . $b) ❌)。
- 大字段 (TEXT/BLOB):需用
send_long_data() 分塊發送,或改用 PDO。
- 預處理不支援的 SQL:某些 DDL、SHOW、CHECK TABLE 不支援預處理,改用
query()。
mysqli vs PDO 選擇建議
| 特性 | mysqli | PDO |
| 資料庫支援 | 僅 MySQL | 12+ 驅動 (MySQL, PostgreSQL, SQLite, SQL Server...) |
| API 風格 | 程序式 + 物件導向 | 純物件導向 |
| 命名參數 | 不支援 | 支援 :name |
| 異步查詢 | 支援 mysqli::poll() | 不支援 (需 Swoole/ReactPHP) |
| 效能 | 略快 (原生) | 極接近 |
| 推薦場景 | 純 MySQL、需異步、舊專案 | 新專案、多資料庫、現代框架 |