萬盛學電腦網

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

PHP MySQL 擴展函數速查表:從 mysql_* 到 mysqli/PDO 遷移指南

重要提醒:mysql_* 函數自 PHP 5.5.0 棄用,PHP 7.0.0 完全移除。現代專案必須使用 mysqli 或 PDO_MySQL。本文提供完整函數對照表、遷移模式與安全最佳實踐。

函數對照表:mysql_* → mysqli (面向物件風格)

舊 mysql_* 函數mysqli 物件導向對應mysqli 程序式對應說明
mysql_connect()$mysqli = new mysqli($host, $user, $pass, $db, $port)mysqli_connect($host, $user, $pass, $db, $port)建立連線
mysql_pconnect()new mysqli('p:' . $host, ...)mysqli_connect('p:' . $host, ...)持久連線 (慎用)
mysql_close()$mysqli->close()mysqli_close($link)關閉連線
mysql_select_db()$mysqli->select_db($db)mysqli_select_db($link, $db)選擇資料庫
mysql_query()$mysqli->query($sql)mysqli_query($link, $sql)執行查詢
mysql_db_query()$mysqli->query($sql) (已選 DB)mysqli_query($link, $sql)指定 DB 查詢
mysql_fetch_array()$result->fetch_array($mode)mysqli_fetch_array($result, $mode)取得關聯/數值陣列
mysql_fetch_assoc()$result->fetch_assoc()mysqli_fetch_assoc($result)取得關聯陣列
mysql_fetch_row()$result->fetch_row()mysqli_fetch_row($result)取得數值索引陣列
mysql_fetch_object()$result->fetch_object()mysqli_fetch_object($result)取得物件
mysql_num_rows()$result->num_rowsmysqli_num_rows($result)結果集行數
mysql_num_fields()$result->field_countmysqli_num_fields($result)欄位數
mysql_free_result()$result->free()mysqli_free_result($result)釋放結果集
mysql_insert_id()$mysqli->insert_idmysqli_insert_id($link)最後自增 ID
mysql_affected_rows()$mysqli->affected_rowsmysqli_affected_rows($link)影響行數
mysql_errno()$mysqli->errnomysqli_errno($link)錯誤代碼
mysql_error()$mysqli->errormysqli_error($link)錯誤訊息
mysql_real_escape_string()$mysqli->real_escape_string($str)mysqli_real_escape_string($link, $str)轉義字串 (參數化查詢更好)
mysql_list_dbs()$mysqli->query('SHOW DATABASES')同上列出資料庫
mysql_list_tables()$mysqli->query('SHOW TABLES')同上列出資料表
mysql_list_fields()$mysqli->query('DESCRIBE table')同上列出欄位
mysql_field_name()$result->fetch_field()->namemysqli_fetch_field($result)->name欄位名
mysql_field_type()$result->fetch_field()->type同上欄位型別
mysql_field_len()$result->fetch_field()->length同上欄位長度
mysql_field_flags()$result->fetch_field()->flags同上欄位旗標
mysql_data_seek()$result->data_seek($offset)mysqli_data_seek($result, $offset)移動結果指標
mysql_create_db()$mysqli->query('CREATE DATABASE ...')同上建立資料庫
mysql_drop_db()$mysqli->query('DROP DATABASE ...')同上刪除資料庫

遷移核心模式對比

1. 連線與錯誤處理


// 舊寫法 (已移除)
$link = mysql_connect('localhost', 'user', 'pass') or die(mysql_error());
mysql_select_db('dbname') or die(mysql_error());

// 新寫法:mysqli 物件導向 (推薦)
$mysqli = new mysqli('localhost', 'user', 'pass', 'dbname');
if ($mysqli->connect_errno) {
    throw new Exception("連線失敗: {$mysqli->connect_error}");
}
$mysqli->set_charset('utf8mb4'); // 重要:設定字符集

// 新寫法:PDO (支援多資料庫、參數綁定更安全)
$pdo = new PDO('mysql:host=localhost;dbname=dbname;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false, // 使用原生預處理
]);

2. 查詢執行與結果處理


// mysqli 物件導向
$result = $mysqli->query("SELECT id, name FROM users WHERE status = 1");
if ($result) {
    while ($row = $result->fetch_assoc()) {
        echo $row['name'];
    }
    $result->free(); // 釋放
}

// PDO (推薦:參數化查詢防 SQL 注入)
$stmt = $pdo->prepare("SELECT id, name FROM users WHERE status = ? AND role = ?");
$stmt->execute([1, 'admin']);
while ($row = $stmt->fetch()) {
    echo $row['name'];
}
// PDOStatement 自動管理游標,無需手動 free

3. 事務控制


// mysqli
$mysqli->begin_transaction();
try {
    $mysqli->query("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
    $mysqli->query("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
    $mysqli->commit();
} catch (Exception $e) {
    $mysqli->rollback();
    throw $e;
}

// PDO
$pdo->beginTransaction();
try {
    $pdo->exec("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
    $pdo->exec("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    throw $e;
}

4. 預處理語句 (防 SQL 注入核心)


// mysqli
$stmt = $mysqli->prepare("INSERT INTO users (email, password_hash) VALUES (?, ?)");
$stmt->bind_param('ss', $email, $passwordHash);
$stmt->execute();

// PDO (命名參數更易讀)
$stmt = $pdo->prepare("INSERT INTO users (email, password_hash) VALUES (:email, :hash)");
$stmt->execute([':email' => $email, ':hash' => $passwordHash]);

進階特性:mysqli 獨有優勢

  • 多查詢執行:$mysqli->multi_query("SELECT * FROM a; SELECT * FROM b;") + next_result()/store_result() 處理多結果集
  • 非同步查詢:$mysqli->query($sql, MYSQLI_ASYNC) + $mysqli->reap_async_query() (高併發場景)
  • SSL/TLS 連線:$mysqli->ssl_set($key, $cert, $ca, $capath, $cipher)
  • 嵌入式伺服器:mysqli_embedded() (測試環境無需獨立 MySQL 進程)

安全檢查清單 (遷移必做)

  1. ✅ 所有動態查詢改用預處理語句 (Prepared Statements)
  2. ✅ 字符集統一設為 utf8mb4 (支援 emoji、完整 Unicode)
  3. ✅ 資料庫使用者最小權限原則 (僅授予必要表的 SELECT/INSERT/UPDATE/DELETE)
  4. ✅ 錯誤訊息不輸出給前端,記錄至日誌系統
  5. ✅ 連線資訊存放於 .env / 配置檔,不寫死在代碼
  6. ✅ 定期輪換資料庫密碼、審計帳號權限

結語

遷移至 mysqli (物件導向) 或 PDO 不只是語法更新,更是安全架構升級。PDO 因其資料庫抽象層、命名參數、異常處理一致性,成為現代 PHP 專案的首選。立即啟動遷移計畫:grep -r "mysql_" src/ 找出所有舊代碼,逐檔重構,納入 CI 檢查禁止引入舊 API。

copyright © 萬盛學電腦網 all rights reserved