萬盛學電腦網

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

PHP Startup: Unable to load dynamic library 解決方案全集

錯誤現象

PHP Warning:  PHP Startup: Unable to load dynamic library 'D:\myserver\php\ext\php_mysql.dll' - 找不到指定模組。
PHP Fatal error:  Call to undefined function mysql_connect()

根本原因

  1. **擴展文件缺失/路徑錯誤**:`php_mysql.dll` 不存在於 `extension_dir` 指定目錄。
  2. **依賴庫缺失**:`libmysql.dll`、`libeay32.dll`、`ssleay32.dll` (OpenSSL) 不在系統 PATH 中。
  3. **PHP 版本/架構不匹配**:x86 PHP 載入 x64 DLL,或 PHP 7+ 載入 PHP 5 的擴展(`mysql` 擴展已在 PHP 7 移除)。
  4. **配置錯誤**:`php.ini` 中 `extension_dir` 錯誤、擴展名拼寫錯誤、未去掉分號。

分步排查解決

1. 確認 PHP 版本與擴展兼容性

  • PHP 7.0+ **已移除** `mysql` 擴展(`mysql_connect` 等函數),**必須改用 `mysqli` 或 `PDO_MySQL`**。
  • 檢查 `php -v` 和 `php -m` 確認版本與已加載模塊。

2. 檢查 php.ini 配置

; 確保 extension_dir 指向正確的 ext 目錄
extension_dir = "D:/myserver/php/ext"

; 啟用擴展(去掉分號)
extension=mysqli
extension=pdo_mysql
; extension=php_mysql.dll  <-- PHP 7+ 刪除此行!

3. 解決依賴庫缺失(關鍵)

將 PHP 目錄下的以下 DLL **複製到系統目錄** 或 **添加 PHP 目錄到系統 PATH 環境變量**:

  • `libmysql.dll` (MySQL 客戶端庫)
  • `libeay32.dll` / `ssleay32.dll` (OpenSSL,PHP 7.2+ 為 `libcrypto-*.dll`/`libssl-*.dll`)
  • PHP 目錄通常為 `C:\php` 或 `D:\myserver\php`
  • 系統目錄:`C:\Windows\System32` (64位) / `C:\Windows\SysWOW64` (32位)

推薦做法:將 PHP 安裝目錄添加到**系統環境變量 PATH**,重啟 Apache/Nginx + PHP-FPM。

4. 驗證加載結果

php -m | findstr /i mysql
# 或創建 info.php
<?php phpinfo(); ?>
// 在瀏覽器查看 "mysqli" "pdo_mysql" 區塊

針對 mysql_connect() 未定義的終極修復

代碼層面必須重寫,因為函數不存在了:

<?php
// 舊代碼 (PHP 5)
$conn = mysql_connect("localhost", "user", "pass");
mysql_select_db("dbname");
mysql_query("SET NAMES utf8");

// 新代碼 (PHP 7+ 推薦 PDO)
$dsn = "mysql:host=localhost;dbname=dbname;charset=utf8mb4";
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
];
try {
    $pdo = new PDO($dsn, "user", "pass", $options);
    echo "連接成功";
} catch (PDOException $e) {
    die("連接失敗: " . $e->getMessage());
}

// 或 mysqli 面向對象
$mysqli = new mysqli("localhost", "user", "pass", "dbname");
if ($mysqli->connect_errno) die("連接失敗: " . $mysqli->connect_error);
$mysqli->set_charset("utf8mb4");

總結檢查清單

  1. PHP 版本是否 ≥ 7.0?→ 必須遷移至 mysqli/PDO。
  2. `extension_dir` 是否正確指向 `ext` 目錄?
  3. 目標 `.dll` 文件是否存在於 `extension_dir`?
  4. 依賴 DLL (`libmysql.dll`, OpenSSL DLLs) 是否在 PATH 中?
  5. 是否重啟了 Web 服務器 / PHP-FPM?
  6. 錯誤日誌是否還有其他缺失依賴提示?
copyright © 萬盛學電腦網 all rights reserved