萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

PDO "could not find driver" 錯誤解決:Windows/Linux 啟用 pdo_mysql 擴展全流程

錯誤現象

PDOException: could not find driver

表示 PHP 找不到 PDO MySQL 驅動擴展(pdo_mysql)。

PDO 連線標準範例

<?php
$dbms = 'mysql';
$host = 'localhost';
$dbName = 'test';
$user = 'root';
$pass = '';
$dsn = "$dbms:host=$host;dbname=$dbName;charset=utf8mb4";

try {
    $pdo = new PDO($dsn, $user, $pass, [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false,
        // PDO::ATTR_PERSISTENT => true  // 長連線,謹慎使用
    ]);
    echo "連線成功";
    $pdo = null; // 關閉連線
} catch (PDOException $e) {
    die("Error: " . $e->getMessage());
}

Windows 環境啟用步驟

  1. 開啟 php.ini(用 php --ini 確認路徑)。
  2. 搜尋 extension=pdo_mysql,取消註釋(移除前面分號):
    extension=pdo_mysql

    PHP 7.2+ 不需 extension=php_pdo.dll,核心已內建 PDO。

  3. 確認 extension_dir 指向正確資料夾(如 ext)。
  4. 重啟 Web 伺服器(Apache/Nginx + PHP-FPM)或 CLI 環境自動生效。
  5. 驗證:php -m | findstr pdo 應顯示 pdo_mysql。

Linux 環境啟用步驟

Ubuntu/Debian (apt 安裝 PHP)

sudo apt update
sudo apt install php-mysql  # 含 pdo_mysql + mysqli
sudo systemctl restart php8.1-fpm  # 或 apache2/nginx

CentOS/RHEL (yum/dnf)

sudo yum install php-mysqlnd  # mysqlnd 內建 pdo_mysql
sudo systemctl restart php-fpm

源碼編譯 PHP

./configure --with-pdo-mysql=mysqlnd --with-mysqli=mysqlnd ...
make && make install
# php.ini 確認 extension=pdo_mysql.so 已載入

驗證

php -m | grep pdo_mysql
php -r "print_r(PDO::getAvailableDrivers());"

常見坑與避雷

現象原因解決
phpinfo() 有 pdo 但無 pdo_mysql只載入 PDO 核心,缺 MySQL 驅動啟用 extension=pdo_mysql
Windows 啟用後仍報錯缺少 libmysql.dll 或 mysqlndPHP 7.4+ 內建 mysqlnd,無需外部 DLL;舊版複製 libmysql.dll 到 PATH 目錄
DSN 寫錯格式錯誤mysql:host=...;dbname=...;charset=utf8mb4
連線成功但中文亂碼未指定 charsetDSN 加 charset=utf8mb4 或執行 SET NAMES utf8mb4

從 mysql_* 遷移到 PDO 的優勢

  • **預處理語句** 防 SQL 注入(prepare() + execute())。
  • **統一介面** 支援 12+ 資料庫驅動,遷移成本低。
  • **物件導向** 異常處理、事務控制更優雅。
  • **效能**:mysqlnd 非阻塞、非緩衝查詢、記憶體效率高。

總結

could not find driver 純粹是 **PDO MySQL 擴展未載入**。Windows 改 php.ini 取消註釋 + 重啟服務;Linux 用套件管理器安裝 php-mysql/php-mysqlnd。新專案請直接使用 **PDO + mysqlnd + utf8mb4 + 預處理**,享受安全、高效、可維護的資料庫存取體驗。

copyright © 萬盛學電腦網 all rights reserved