萬盛學電腦網

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

PHP 連接 MySQL 兩大方式總結:mysqli vs mysql (已棄用) 與亂碼徹底解決

PHP 連接 MySQL 歷經 mysql (已移除)、mysqli、PDO 三代。本文聚焦 mysqli 物件導向風格 (推薦) 與舊式 mysql 函數對比,並給出徹底解決中文亂碼的標準化配置清單。

環境檢查與擴充啟用

; php.ini
extension=mysqli          ; 必須啟用
; extension=pdo_mysql     ; 推薦同時啟用 PDO

; extension_dir = "ext"   ; 確認路徑正確 (Windows)
; 重啟 Web 服務 (Apache/Nginx+PHP-FPM)

方式一:mysqli 物件導向 (推薦,PHP 5.0+)

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

方式二:mysql 函數式 (PHP 7.0 已完全移除,僅供維護舊代碼參考)

<?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 vs mysql 關鍵差異

特性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 │
└─────────────────────────────────────────────────────────────┘
缺一不可!

最佳實踐:PDO (現代標準)

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

遷移建議

  1. 新專案:直接使用 PDO,資料庫抽象層最完善
  2. 舊專案 mysqli:可繼續使用,逐步遷移至 PDO
  3. 舊專案 mysql:必須立即遷移,安全風險極高,PHP 7+ 無法運行
  4. 統一封裝:專案建立 Database 類封裝 PDO,提供統一介面

常見錯誤排查

  • Class 'mysqli' not found → php.ini 未啟用 extension=mysqli
  • Access denied → 帳號密碼錯誤、權限不足、主機限制
  • 亂碼 → 檢查四層編碼一致性、確認資料表實際編碼 SHOW CREATE TABLE
  • MySQL server has gone away → 超時、封包過大 (max_allowed_packet)、連線閒置

確立 mysqli 物件導向 或 PDO 為專案標準,嚴格執行四層編碼一致性,能從根源消除 MySQL 連線與亂碼問題。

copyright © 萬盛學電腦網 all rights reserved