PHP 連接 MySQL 深度解析：雙介面架構差異、連線選項、連線池、安全配置與生產環境實戰

PHP 連接 MySQL 有兩大核心介面：MySQLi (MySQL Improved) 與 PDO (PHP Data Objects)。選擇正確的介面、配置最佳連線參數、實作健全錯誤處理，是資料庫應用穩定性的基石。本文系統性比較兩者架構、提供完整連線代碼模板、解析進階選項與最佳實務。

MySQLi vs PDO：核心架構差異

選擇建議

• 新專案：強烈推薦 PDO — 現代、統一、可移植、例外導向
• 純 MySQL 既有專案：MySQLi 可接受，但新模組建議 PDO
• 需多資料庫支援：PDO 唯一選擇
• 高併發異步需求：MySQLi async 或 Swoole/ReactPHP + PDO

標準連線代碼模板

MySQLi 物件導向 (含完整錯誤處理)

<?php
$host = 'localhost'; $port = 3306; $user = 'user'; $pass = 'pass'; $db = 'dbname';

$mysqli = @new mysqli($host, $user, $pass, $db, $port);
if ($mysqli->connect_errno) {
    // 生產環境記錄日誌，不輸出詳細錯誤給用戶
    error_log("MySQL 連線失敗 [{$mysqli->connect_errno}]: {$mysqli->connect_error}");
    throw new RuntimeException("資料庫連線失敗，請稍後再試");
}

// 設定字元集 (關鍵！)
$mysqli->set_charset('utf8mb4');

// 可選：設定時區
$mysqli->query("SET time_zone = '+00:00'");

// 可選：關閉自動提交 (交易控制)
$mysqli->autocommit(false);

return $mysqli;

MySQLi 程序式

$conn = @mysqli_connect($host, $user, $pass, $db, $port);
if (!$conn) {
    error_log("MySQL 連線失敗: " . mysqli_connect_error());
    throw new RuntimeException("資料庫連線失敗");
}
mysqli_set_charset($conn, 'utf8mb4');
mysqli_autocommit($conn, false);
return $conn;

PDO (生產環境標準配置)

<?php
$host = 'localhost'; $port = 3306; $db = 'dbname'; $user = 'user'; $pass = 'pass';
$charset = 'utf8mb4';

$dsn = "mysql:host=$host;port=$port;dbname=$db;charset=$charset";

$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,      // 例外模式
    PDO::ATTR_EMULATE_PREPARES   => false,                       // 真實預處理
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,            // 關聯陣列
    PDO::ATTR_STRINGIFY_FETCHES  => false,                       // 保持原生型別
    PDO::ATTR_PERSISTENT         => false,                       // 非持久連線 (見下文)
    PDO::MYSQL_ATTR_INIT_COMMAND => "SET time_zone = '+00:00'",  // 連線初始化指令
];

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
    return $pdo;
} catch (PDOException $e) {
    error_log("PDO 連線失敗 [{$e->getCode()}]: {$e->getMessage()}");
    throw new RuntimeException("資料庫連線失敗，請稍後再試");
}

進階連線選項深度解析

持久連線 (Persistent Connections)

SSL/TLS 加密連線 (生產環境強制)

$options[PDO::MYSQL_ATTR_SSL_CA] = '/etc/ssl/mysql/ca.pem';
$options[PDO::MYSQL_ATTR_SSL_CERT] = '/etc/ssl/mysql/client-cert.pem';
$options[PDO::MYSQL_ATTR_SSL_KEY] = '/etc/ssl/mysql/client-key.pem';
$options[PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = true;
// DSN 不變，驅動自動協商 SSL

Unix Domain Socket (本機最高效能)

// PDO
$dsn = "mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=$db;charset=$charset";

// MySQLi
$mysqli = new mysqli('localhost', $user, $pass, $db, 0, '/var/run/mysqld/mysqld.sock');

連線超時控制

// PDO (PHP 7.1+)
$options[PDO::ATTR_TIMEOUT] = 5; // 秒，連線階段超時

// MySQLi
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);

// 查詢超時需 SQL 層面設定
$pdo->exec("SET MAX_EXECUTION_TIME=30000"); // 毫秒，MySQL 5.7.8+

錯誤處理策略

連線池與高併發架構

PHP 傳統模式 (PHP-FPM/Apache mod_php) 每請求建立連線，無內建連線池。高併發方案：

1. PHP-FPM + 靜態/動態程序管理：調整 pm.max_children、pm.start_servers 匹配 DB max_connections
2. 持久連線謹慎使用：配合 mysqli.rollback_on_cached_plink (PHP 8.1+)
3. 應用層連線池：Swoole/OpenSwoole/RoadRunner + PDO 協程連線池
4. ProxySQL：中介層連線池、讀寫分離、查詢重寫、快取
5. 唯讀副本分流：主庫寫入、從庫讀取，應用層或 ProxySQL 路由

安裝驗證

<?php
// 檢查擴展載入
var_dump(extension_loaded('mysqli'));
var_dump(extension_loaded('pdo_mysql'));

// 檢查客戶端庫版本
echo "MySQLi client version: " . mysqli_get_client_info() . "\n";
$pdo = new PDO('mysql:host=localhost', 'user', 'pass');
echo "PDO MySQL client version: " . $pdo->getAttribute(PDO::ATTR_CLIENT_VERSION) . "\n";

總結

PHP 連接 MySQL 的核心決策：選 PDO、用例外模式、關閉模擬預處理、設定 utf8mb4、關閉持久連線、生產環境強制 SSL、統一錯誤處理層。MySQLi 保留給純 MySQL 既有專案或需異步/多重結果集的特殊場景。建立標準化連線工廠類別，封裝配置、重試、監控、審計，是專業 PHP 團隊的基本功。

1. 上一篇文章： PHP MySQL 建立資料庫完整指南：CREATE DATABASE、字元集配置、權限與三大介面實作
2. 下一篇文章： PHP 與 MySQL 入門：從基礎概念到實戰查詢

PHP 入門

PHP 多維陣列完整指南：建立、存取、遍歷與實務應用

PHP 多維陣列完整指南 多維陣列是「陣列的陣列」，能以表格

前端開發者工具箱：20 款提效神器精選指南

設計與原型 工具核心價值適用場景

AjaXplorer：PHP 打造的強大 Web 檔案管理器，替代 FTP 的最佳選擇

當 VPS 無法安裝 FTP 服務，或需透過瀏覽器直接管理伺

Discuz! UCenter 同步登錄機制深度解析

同步登錄概述 Discuz! 架構下，UCenter 作為用