在 PHP 開發中,資料庫操作是核心環節。然而,許多開發者在資料庫設計、存取邏輯及業務代碼中容易陷入一些經典陷阱,導致效能低下、安全漏洞甚至資料不一致。本文整理了 5 種最常見的 PHP 資料庫錯誤,並提供現代化的解決方案,助你寫出更健壯、安全的代碼。
mysql_* 函數早期 PHP 代碼常直接呼叫 mysql_connect()、mysql_query() 等函數。這不僅因 PHP 7.0 已移除該擴充套件而無法運行,更存在嚴重的 SQL 注入風險,且將代碼綁定於 MySQL,難以遷移。
<?php
function get_user_id($name) {
$db = mysql_connect('localhost', 'root', 'password');
mysql_select_db('users');
$res = mysql_query("SELECT id FROM users WHERE login='".$name."'");
while ($row = mysql_fetch_array($res)) { $id = $row[0]; }
return $id;
}
var_dump(get_user_id('jack'));
?>
推薦使用 PDO (PHP Data Objects) 或 PEAR DB 等抽象層。它們提供資料庫無關的介面,支援預處理語句,有效防禦 SQL 注入,且輕鬆切換底層資料庫 (MySQL、PostgreSQL、SQLite 等)。
<?php
function get_user_id(PDO $pdo, $name) {
$stmt = $pdo->prepare('SELECT id FROM users WHERE login = ?');
$stmt->execute([$name]);
return $stmt->fetchColumn();
}
// 建立 PDO 連線 (僅需一次,建議使用單例或依賴注入)
$pdo = new PDO('mysql:host=localhost;dbname=users;charset=utf8mb4', 'root', 'password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
var_dump(get_user_id($pdo, 'jack'));
?>
關鍵優勢: 參數綁定 (?) 徹底分離代碼與數據,消除注入隱患;例外模式讓錯誤處理更優雅;支援事務、預處理語句複用等進階特性。
許多開發者習慣先 SELECT MAX(id) 再 +1 插入新記錄。這在高併發下會產生競態條件導致主鍵衝突,且效能低下,多一次查詢開銷。
-- 錯誤表結構
CREATE TABLE users (
id MEDIUMINT,
login TEXT,
password TEXT
);
-- PHP 手動生成 ID
$res = $db->query("SELECT max(id) FROM users");
$id = $res->fetchColumn() + 1;
$db->execute("INSERT INTO users VALUES (?, ?, ?)", [$id, $name, $pass]);
AUTO_INCREMENT-- 正確表結構
CREATE TABLE users (
id MEDIUMINT NOT NULL AUTO_INCREMENT PRIMARY KEY,
login VARCHAR(50) NOT NULL,
password VARCHAR(255) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-- PHP 代碼簡潔高效
$stmt = $pdo->prepare('INSERT INTO users (login, password) VALUES (?, ?)');
$stmt->execute([$name, $password_hash]);
$new_id = $pdo->lastInsertId();
資料庫引擎保證原子性生成唯一 ID,無鎖競爭,效能最優。同理,PostgreSQL 使用 SERIAL 或 IDENTITY,SQL Server 使用 IDENTITY。
缺乏適當索引是效能殺手。常見問題:外鍵欄位無索引、頻繁用於 WHERE/JOIN/ORDER BY 的欄位未建索引、過度索引導致寫入變慢。
EXPLAIN 分析慢查詢,避免全表掃描。在 foreach 迴圈內查詢資料庫是典型反模式。例如:先查用戶列表,再迴圈查每個用戶的訂單。若有 100 用戶,將執行 101 次查詢。
// 錯誤:N+1 查詢
$users = $pdo->query('SELECT * FROM users')->fetchAll();
foreach ($users as $user) {
$orders = $pdo->query("SELECT * FROM orders WHERE user_id = {$user['id']}")->fetchAll();
$user['orders'] = $orders;
}
// 正確:單次 JOIN 查詢
$sql = 'SELECT u.*, o.* FROM users u LEFT JOIN orders o ON u.id = o.user_id';
$rows = $pdo->query($sql)->fetchAll();
// 在 PHP 中重組數據結構,或使用 ORM 的 eager loading (如 Laravel Eloquent 的 with())
長連線 (pconnect) 易導致連線耗盡;未關閉游標、結果集佔用記憶體;異常時連線未釋放。
try-catch-finally 或 PDO 物件的析構函數自動清理。避開這 5 大錯誤,核心原則是:拥抱現代化抽象層 (PDO)、善用資料庫原生特性 (自增主鍵、索引、事務)、集合化思維替代迴圈查詢、嚴格資源管理。這不僅能修復現有隱患,更能為系統擴展奠定堅實基礎。