PHP 連接 MySQL 歷經 mysql (已移除)、mysqli、PDO 三代。本文聚焦 mysqli 物件導向風格 (推薦) 與舊式 mysql 函數對比,並給出徹底解決中文亂碼的標準化配置清單。
; php.ini
extension=mysqli ; 必須啟用
; extension=pdo_mysql ; 推薦同時啟用 PDO
; extension_dir = "ext" ; 確認路徑正確 (Windows)
; 重啟 Web 服務 (Apache/Nginx+PHP-FPM)
<?php
$mysqli = new mysqli("127.0.0.1", "user", "pass", "dbname");
// 連線檢查
if ($mysqli->connect_errno) {
die("連線失敗: " . $mysqli->connect_error);
}
// 關鍵:設定字符集 (防亂碼)
$mysqli->set_charset("utf8mb4"); // 推薦 utf8mb4 支援 Emoji
// 查詢
$query = "SELECT * FROM `table` ORDER BY theindex DESC";
$result = $mysqli->query($query);
if ($result) {
while ($row = $result->fetch_assoc()) {
echo "{$row['theindex']} {$row['name']}<br>";
}
$result->free();
}
$mysqli->close();
?>
<?php
$conn = @mysql_connect("localhost", "user", "pass");
if (!$conn) die("連線失敗: " . mysql_error());
// 設定字符集 (兩個都要設)
mysql_query("SET NAMES 'utf8'", $conn);
mysql_select_db("dbname", $conn);
$rs = mysql_query("SELECT * FROM `table` ORDER BY theindex DESC", $conn);
if ($rs) {
echo "<table border=1>";
while ($row = mysql_fetch_assoc($rs)) {
echo "<tr><td>{$row['theindex']}</td><td>{$row['name']}</td></tr>";
}
echo "</table>";
mysql_free_result($rs);
}
mysql_close($conn);
?>
| 特性 | mysqli (推薦) | mysql (已移除) |
|---|---|---|
| API 風格 | 物件導向 + 程序式雙支援 | 僅程序式 |
| 預處理語句 | ✅ 原生支援 | ❌ 不支援 |
| 多查詢 | ✅ multi_query | ❌ |
| 事務控制 | ✅ commit/rollback | ❌ |
| 增強除錯 | ✅ $mysqli->error_list | ❌ |
| PHP 版本 | 5.0 - 8.3+ | 5.0 - 5.6 (7.0 移除) |
┌─────────────────────────────────────────────────────────────┐
│ 1. PHP 檔案編碼 → UTF-8 無 BOM (編輯器存檔設定) │
│ 2. HTML 頁面編碼 → <meta charset="UTF-8"> │
│ 3. 資料庫連線編碼 → SET NAMES utf8mb4 / $mysqli->set_charset('utf8mb4') │
│ 4. 資料表/欄位編碼 → CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci │
└─────────────────────────────────────────────────────────────┘
缺一不可!
<?php
$dsn = 'mysql:host=127.0.0.1;dbname=test;charset=utf8mb4';
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false, // 真正預處理
];
$pdo = new PDO($dsn, 'user', 'pass', $options);
$stmt = $pdo->prepare("SELECT * FROM `table` WHERE id = ?");
$stmt->execute([$_GET['id']]);
$row = $stmt->fetch();
echo $row['name'];
?>
Class 'mysqli' not found → php.ini 未啟用 extension=mysqliAccess denied → 帳號密碼錯誤、權限不足、主機限制SHOW CREATE TABLEMySQL server has gone away → 超時、封包過大 (max_allowed_packet)、連線閒置確立 mysqli 物件導向 或 PDO 為專案標準,嚴格執行四層編碼一致性,能從根源消除 MySQL 連線與亂碼問題。