萬盛學電腦網

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

PHP 資料庫開發必知的 5 大常見錯誤與解決方案

前言

在 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 或資料庫抽象層

推薦使用 PDO (PHP Data Objects) 或 PEAR DB 等抽象層。它們提供資料庫無關的介面,支援預處理語句,有效防禦 SQL 注入,且輕鬆切換底層資料庫 (MySQL、PostgreSQL、SQLite 等)。

使用 PDO 的最佳實踐

<?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'));
?>

關鍵優勢: 參數綁定 (?) 徹底分離代碼與數據,消除注入隱患;例外模式讓錯誤處理更優雅;支援事務、預處理語句複用等進階特性。

錯誤二:手動管理主鍵 ID,不使用自動遞增

許多開發者習慣先 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 分析慢查詢,避免全表掃描。
  • 刪除未使用的索引,減少寫入開銷。

錯誤四:在迴圈中執行 SQL 查詢 (N+1 問題)

在 foreach 迴圈內查詢資料庫是典型反模式。例如:先查用戶列表,再迴圈查每個用戶的訂單。若有 100 用戶,將執行 101 次查詢。

優化策略:批次查詢 / JOIN / 預載入

// 錯誤: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) 易導致連線耗盡;未關閉游標、結果集佔用記憶體;異常時連線未釋放。

最佳實踐

  • 使用 連線池 (如 PHP-FPM + PDO 持久連線需謹慎配置) 或短連線模式,確保請求結束自動釋放。
  • 善用 try-catch-finally 或 PDO 物件的析構函數自動清理。
  • 避免在長時間運行的腳本 (如 CLI 任務) 中持有閒置連線,定期重連。

總結

避開這 5 大錯誤,核心原則是:拥抱現代化抽象層 (PDO)、善用資料庫原生特性 (自增主鍵、索引、事務)、集合化思維替代迴圈查詢、嚴格資源管理。這不僅能修復現有隱患,更能為系統擴展奠定堅實基礎。

copyright © 萬盛學電腦網 all rights reserved