萬盛學電腦網

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

PHP "mysql_connect() 不支援" 錯誤徹底排查:模組載入、DLL 地獄與環境變數配置

錯誤現象

PHP 5.3+ 環境下呼叫 mysql_connect() 拋出:Call to undefined function mysql_connect() 或「不支援,請檢查 mysql 模組是否正確加載」。

根本原因

PHP 5.5 起 **移除** `mysql` 擴展(已棄用),7.0 完全刪除。僅保留 `mysqli`、`PDO_MySQL`。舊代碼必須遷移或安裝舊版擴展(不建議)。

診斷步驟

1. 檢查 phpinfo()

建立 phpinfo.php:

<?php phpinfo(); ?>

搜尋「mysql」區塊:若無 MySQL Support enabled**,代表擴展未載入。

2. 檢查 php.ini 載入設定

; Windows
extension=php_mysql.dll      ; PHP 5.3~5.6 才有
extension=php_mysqli.dll     ; 推薦使用
extension=php_pdo_mysql.dll  ; 推薦使用

; Linux
extension=mysqli.so
extension=pdo_mysql.so

確認 extension_dir 路徑正確,DLL/so 檔案存在。

Windows 環境常見 DLL 地獄解決

  1. 複製 DLL 到系統目錄:將 PHP 目錄下的 libmysql.dll、php_mysql.dll、php_mysqli.dll 複製到 C:\Windows\System32(64 位系統也放 System32,SysWOW64 給 32 位程式用)。
  2. 將 PHP 目錄加入系統 PATH:
    • 控制台 → 系統 → 進階系統設定 → 環境變數 → 系統變數 Path → 編輯 → 新增 C:\php(你的 PHP 安裝路徑)。
    • **重啟電腦** 或重啟 Apache/服務生效。
  3. Apache httpd.conf 載入 libmysql.dll(舊版做法):
    LoadFile "C:/php/libmysql.dll"

現代化遷移建議(根治)

方案 A:改用 mysqli(程序風格相似,易遷移)

$link = mysqli_connect('localhost', 'user', 'pass', 'db');
mysqli_set_charset($link, 'utf8mb4');
$result = mysqli_query($link, 'SELECT * FROM users');
while ($row = mysqli_fetch_assoc($result)) { /* ... */ }
mysqli_close($link);

方案 B:改用 PDO(物件導向、支援多資料庫、預處理防注入)

$pdo = new PDO('mysql:host=localhost;dbname=db;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
]);
$stmt = $pdo->query('SELECT * FROM users');
foreach ($stmt as $row) { /* ... */ }

方案 C:若必須維護極舊代碼(PHP 5.6 以下)

  • 安裝 PECL `mysql` 擴展:`pecl install mysql`(需編譯工具鏈)。
  • 或使用 Docker 封裝舊版 PHP 環境隔離運行。

Linux 編譯安裝 PHP 時啟用 MySQL 支援

./configure --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd --with-mysql-sock=/tmp/mysql.sock
# mysqlnd (MySQL Native Driver) 為內建驅動,無需外部 libmysqlclient,效能更好

總結

mysql_connect() 是歷史遺物。**立即遷移至 mysqli 或 PDO** 是唯一正解。Windows 上若遇 DLL 載入問題,核心在於:PHP 目錄在 PATH 中 + 正確 php.ini 指向 extension_dir + 相依 DLL 可被系統找到。新專案請直接使用 PHP 8.x + PDO + 嚴格類型,擁抱現代化開發。

copyright © 萬盛學電腦網 all rights reserved