萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP mysqli 預處理語句插入資料:防注入與效能最佳實踐

前言

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 類型範例
iintegerINT, TINYINT, BIGINT
dfloat/doubleFLOAT, DOUBLE, DECIMAL
sstringVARCHAR, TEXT, DATE, DATETIME, JSON
bstring (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 選擇建議

特性mysqliPDO
資料庫支援僅 MySQL12+ 驅動 (MySQL, PostgreSQL, SQLite, SQL Server...)
API 風格程序式 + 物件導向純物件導向
命名參數不支援支援 :name
異步查詢支援 mysqli::poll()不支援 (需 Swoole/ReactPHP)
效能略快 (原生)極接近
推薦場景純 MySQL、需異步、舊專案新專案、多資料庫、現代框架
copyright © 萬盛學電腦網 all rights reserved