Windows 下配置 Apache Server 支援 PHP 與 Perl CGI 完整教學

前言

許多個人站長在 Windows 環境下開發網站，需要一個本地測試環境來調試 PHP 與 CGI 程式。Apache HTTP Server 是最經典的選擇，單一安裝即可同時支援 PHP、Perl CGI 等多種腳本語言。本文整理了在 Windows 單機環境下安裝、配置 Apache Server 的完整步驟，包含基礎設定、Perl CGI 支援與 PHP 模組啟用，適合初學者快速建立本地開發環境。

一、Apache Server 安裝

1. 前往 Apache 官方鏡像站點 下載 Windows 版安裝檔（檔名通常為 apache_1_3_x.win32.exe，現代版本請至 Apache Lounge 取得最新穩定版）。
2. 執行安裝程式，建議將安裝目錄設為根目錄（如 C:\Apache），方便後續配置與維護。
3. 選擇 Custom（自定義） 安裝類型，可依需求勾選：應用程式檔案、原始碼、線上手冊、附加模組、圖示、必要目錄等。
4. 安裝完成後，Apache 會自動完成基本配置。使用文字編輯器（如 UltraEdit、VS Code、Notepad++）開啟 conf/httpd.conf 檢視預設設定。

二、Apache 基礎配置

編輯 conf/httpd.conf，依序修改下列關鍵指令：

1. ServerName：定義伺服器域名（如 localhost 或自訂域名），移除行首的 # 註解符號。
2. ServerAdmin：填入管理者電子郵件，單機測試可略過。
3. 目錄存取權限：找到 <Directory /> 區塊，將 Options 與 AllowOverride 參數均設為 All（注意大小寫）。
4. DocumentRoot：指定網站根目錄（存放網頁檔案的資料夾），路徑使用正斜線 /，結尾不加斜線。
5. DirectoryIndex：設定預設首頁檔案名稱（如 index.html index.php）。

儲存後啟動 Apache 服務，在瀏覽器輸入 https://localhost/ 若看到預設頁面即代表基本配置成功。

三、啟用 Perl CGI 支援

1. 先安裝 Strawberry Perl 或 ActivePerl（假設安裝於 C:\Perl）。
2. 編輯 httpd.conf：
   • 找到 ScriptAlias /cgi-bin/ "C:/Apache/cgi-bin/"，移除前方 #，並將路徑指向存放 CGI 腳本的目錄。
   • 同步修改對應的 <Directory> 區塊路徑，並設定 Options All、AllowOverride All。
   • 找到 AddHandler cgi-script .cgi，移除註解並在後方加入 .pl（即 AddHandler cgi-script .cgi .pl）。
3. 重要：CGI 腳本首行的 Perl 解譯器路徑必須改為 Windows 格式，例如 #!C:/Perl/bin/perl，否則會出現 500 Internal Server Error。

四、啟用 PHP 支援

1. 下載 PHP for Windows（建議 Non Thread Safe 版本），解壓至 C:\php。
2. 在 httpd.conf 末尾加入以下配置（以 PHP 5/7/8 為例，依實際版本調整）：

   # 載入 PHP 模組（Apache 2.4 範例）
   LoadModule php_module "C:/php/php8apache2_4.dll"
   # 設定 PHP 處理副檔名
   AddType application/x-httpd-php .php .php3 .phtml
   # 指定 php.ini 路徑
   PHPIniDir "C:/php"
   

3. 將 php.ini-development 複製為 php.ini，並依需求啟用擴充模組（如 extension=mysqli、extension=pdo_mysql 等）。
4. 重新啟動 Apache，於網站根目錄建立 phpinfo.php（內容 <?php phpinfo(); ?>），瀏覽器訪問確認 PHP 運作正常。

五、驗證與常見問題

• CGI 腳本放置於 ScriptAlias 指定目錄，PHP 腳本可放置於 DocumentRoot 任意子目錄（除 cgi-bin 外）。
• 若遇到 500 錯誤，請檢查 Apache 錯誤日誌（logs/error.log），常見原因：腳本首行路徑錯誤、檔案權限不足、語法錯誤。
• 路徑分隔符在 Apache 設定檔中一律使用正斜線 /，即使在 Windows 環境亦同。

完成上述步驟，您的 Windows 本機即擁有同時支援 PHP 與 Perl CGI 的 Apache 開發環境，可輕鬆進行本地測試與開發。祝您開發順利！