在 Windows 環境下將 PHP 安裝到 C:\Program Files\php 等包含空格的路徑,配置 Apache 加載 PHP 模塊後,Apache 無法啟動,錯誤日誌無明確提示。
Apache 配置文件(httpd.conf)解析參數時,空格被視為參數分隔符。配置行:
LoadModule php5_module "C:/Program Files/php/php5apache2_2.dll"
PHPIniDir "C:/Program Files/php"
Apache 實際解析為三個參數:"C:/Program、Files/php/php5apache2_2.dll"、PHPIniDir... 導致模塊路徑解析失敗。
Windows 自動為長路徑生成短別名:
C:\> dir /x "C:\Program Files"
# 輸出示例:
# PROGRA~1 Program Files
# 配置修改為:
LoadModule php5_module "C:/PROGRA~1/php/php5apache2_2.dll"
PHPIniDir "C:/PROGRA~1/php"
優點:無需移動文件,即時生效。缺點:短路徑名可能因系統設置而禁用(fsutil behavior set disable8dot3 1)。
將 PHP 安裝到無空格路徑,如 C:\php、D:\php:
LoadModule php5_module "C:/php/php5apache2_2.dll"
PHPIniDir "C:/php"
這是最穩健、兼容性最好的方案,避免所有空格相關解析問題。
LoadModule php5_module "\"C:/Program Files/php/php5apache2_2.dll\""
PHPIniDir "\"C:/Program Files/php\""
Apache 某些版本對嵌套引號支持不佳,極易導致配置語法錯誤。
httpd -t 測試配置語法httpd -k start 或服務管理器啟動https://localhost/phpinfo.php 確認 PHP 模塊載入成功D:\server\php/ 作為路徑分隔符(Apache 配置跨平台兼容)httpd -t 語法檢查這個「引號引發的悲劇」是 Windows 下部署 PHP 最經典的坑之一,遵循「路徑無空格」原則可一勞永逸。