重要提醒:mysql_* 函數自 PHP 5.5.0 棄用,PHP 7.0.0 完全移除。現代專案必須使用 mysqli 或 PDO_MySQL。本文提供完整函數對照表、遷移模式與安全最佳實踐。
| 舊 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_rows | mysqli_num_rows($result) | 結果集行數 |
| mysql_num_fields() | $result->field_count | mysqli_num_fields($result) | 欄位數 |
| mysql_free_result() | $result->free() | mysqli_free_result($result) | 釋放結果集 |
| mysql_insert_id() | $mysqli->insert_id | mysqli_insert_id($link) | 最後自增 ID |
| mysql_affected_rows() | $mysqli->affected_rows | mysqli_affected_rows($link) | 影響行數 |
| mysql_errno() | $mysqli->errno | mysqli_errno($link) | 錯誤代碼 |
| mysql_error() | $mysqli->error | mysqli_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()->name | mysqli_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 ...') | 同上 | 刪除資料庫 |
// 舊寫法 (已移除)
$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, // 使用原生預處理
]);
// 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
// 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;
}
// 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->multi_query("SELECT * FROM a; SELECT * FROM b;") + next_result()/store_result() 處理多結果集$mysqli->query($sql, MYSQLI_ASYNC) + $mysqli->reap_async_query() (高併發場景)$mysqli->ssl_set($key, $cert, $ca, $capath, $cipher)mysqli_embedded() (測試環境無需獨立 MySQL 進程)utf8mb4 (支援 emoji、完整 Unicode).env / 配置檔,不寫死在代碼遷移至 mysqli (物件導向) 或 PDO 不只是語法更新,更是安全架構升級。PDO 因其資料庫抽象層、命名參數、異常處理一致性,成為現代 PHP 專案的首選。立即啟動遷移計畫:grep -r "mysql_" src/ 找出所有舊代碼,逐檔重構,納入 CI 檢查禁止引入舊 API。