UNIX 環境 PHP 模組安裝至 Apache 後無法運作排查清單

現象

依安裝步驟將 PHP 編譯為 Apache 模組，但瀏覽 .php 頁面顯示原始碼或 404，模組未生效。

三步驟排查

1. 確認執行中的 httpd 為新編譯版本：

   /path/to/httpd -l

   輸出清單中必須包含 mod_php3.c（或 mod_php4.c/mod_php5.c）。若無，重新編譯安裝 Apache。
2. 確認 httpd.conf 已正確加入 MIME 類型：

   AddType application/x-httpd-php3 .php3

   • 勿放在 <VirtualHost> 或 <Directory> 區塊內，否則不生效。
   • 現代版本：AddType application/x-httpd-php .php
3. 確認讀取的是正確的設定檔：
   • Apache 1.2.x 與 1.3.x 設定檔路徑不同。
   • 測試法：在 httpd.conf 故意加入錯誤語法，重啟 Apache 若報錯即為正確檔案。

常見疏漏

• 未重啟 Apache（apachectl restart）。
• LoadModule 指令路徑錯誤（需指向實際 libphp*.so）。
• SELinux / AppArmor 阻擋模組載入（檢查 audit.log）。