萬盛學電腦網

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

Apache 載入 PHP 模組啟動失敗:php5apache2_2.dll / php5apache2_4.dll 版本不匹配完整排查指南

Apache 原本正常,配置 PHP 後無法啟動,錯誤 Cannot load php5apache2_2.dll into server(或 php5apache2_4.dll)。核心原因:**Apache 版本與 PHP 模組檔案不匹配**。

版本對應關係表

Apache 版本所需 PHP 模組檔案PHP 版本支援
Apache 2.0php5apache2.dllPHP 5.2
Apache 2.2php5apache2_2.dllPHP 5.2、5.3、5.4
Apache 2.4php5apache2_4.dllPHP 5.3、5.4、5.5+

排查步驟

  1. 確認 Apache 版本:httpd -v 或查看安裝目錄
  2. 檢查 PHP 解壓目錄:是否存在對應的 php5apache2_x.dll
  3. httpd.conf 載入指令:
    LoadModule php5_module "D:/php/php5apache2_4.dll"
    PHPIniDir "D:/php/"
  4. VC Runtime 相容性:
    • PHP 5.3/5.4 → VC9 (VS2008) → VC9 x86
    • PHP 5.5/5.6 → VC11 (VS2012) → VC11 x86
    • PHP 7.0+ → VC14 (VS2015+) → VC14+ x86/x64
    • Apache 官方編譯通常用 VC9/VC11/VC14,**PHP 與 Apache 必須同一 VC 版本**
  5. 架構一致:全 32-bit (x86) 或全 64-bit (x64),不可混用
  6. Thread Safety:Apache 模組需 **Thread Safe (TS)** 版 PHP,非 NTS

常見錯誤組合

ApachePHP模組檔結果
2.45.6 (VC11)php5apache2_4.dll ✓✅ 正常
2.45.3 (VC9)php5apache2_4.dll ✓⚠️ VC 不匹配,可能啟動失敗
2.25.6 (VC11)php5apache2_2.dll ✗ (5.6 無此檔)❌ 缺少模組檔
2.47.4 (VC15)php7apache2_4.dll ✓✅ 正常 (PHP 7 命名變更)

快速驗證

# 檢查模組檔案存在
ls -la php5apache2_4.dll

# 檢查相依 DLL (Windows)
# 使用 Dependency Walker (depends.exe) 開啟 php5apache2_4.dll
# 確認 MSVCR90.dll / MSVCR110.dll / VCRUNTIME140.dll 存在

最佳實務建議

  • **統一來源下載**:從 windows.php.net 下載對應 VC 版本的 PHP,從 Apache Lounge 下載同 VC 版本的 Apache
  • **升級建議**:PHP 5.x 已停止維護,新專案請用 PHP 8.x + Apache 2.4 (VC15+)
  • **容器化**:Docker 官方映像 php:8.2-apache 完全避開版本地獄

版本對應是 Apache+PHP 整合的第一道關卡,對上版號、VC Runtime、Thread Safety、架構四項一致,99% 問題迎刃而解。

copyright © 萬盛學電腦網 all rights reserved