Apache + PHP 環境配置詳解：PHPIniDir 指令與 php.ini 載入順序

Apache 整合 PHP 關鍵配置：PHPIniDir 完全指南

在 Apache 以模組模式運行 PHP 時，PHPIniDir 指令是指定 php.ini 路徑的關鍵。本文詳細說明其作用、php.ini 搜尋順序與實際配置範例。

PHPIniDir 作用

告訴 Apache 載入的 PHP 模組去哪裡讀取 php.ini。僅適用於 mod_php（Apache 2 module），CLI 模式無效。

PHP 5+ php.ini 搜尋順序（優先級遞減）

1. PHPIniDir (Apache 2 module only)
2. 註冊表鍵值：HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath (Windows)
3. 環境變數：PHPRC
4. PHP 目錄（CLI）或 Web 伺服器目錄（SAPI 模組）
5. Windows 系統目錄（C:\windows 或 C:\winnt）

若未設定 PHPIniDir，PHP 會依序嘗試上述位置，容易導致載入非預期的設定檔。

httpd.conf 實際配置範例

# 載入 PHP 模組（路徑依實際安裝調整）
LoadModule php5_module "C:/php/php5apache2_4.dll"

# 指定 php.ini 目錄（注意：是目錄，非檔案路徑）
PHPIniDir "C:/php"

# 關聯 .php 副檔名
AddType application/x-httpd-php .php

# 可選：設定預設首頁
DirectoryIndex index.php index.html

常見錯誤與排查

驗證配置是否生效

<?php
phpinfo();
// 瀏覽器查看：
// Loaded Configuration File → C:\php\php.ini
// PHPIniDir → C:\php

補充：PHP-FPM 模式下的配置差異

現代生產環境多採用 Nginx/Apache + PHP-FPM，此時 不使用 PHPIniDir，而是：

• PHP-FPM 進程啟動時自動讀取安裝目錄下的 php.ini
• 或透過 --php-ini 參數指定
• 各 Pool 可在 php-fpm.conf 覆蓋特定設定

最佳實務建議

1. 生產環境務必在 httpd.conf 明確設定 PHPIniDir
2. 將 php.ini 放在 PHP 安裝目錄，避免放在系統目錄
3. 不同專案需不同設定時，使用 .user.ini（PHP 5.3+）或 PHP-FPM Pool 隔離
4. 修改 php.ini 後必須重啟 Apache（mod_php 模式）或 reload PHP-FPM