Windows 環境下 Apache 配置虛擬主機完整指南

在 Windows 本地開發環境中，配置 Apache 虛擬主機能讓專案使用獨立域名（如 www.mydemo.com）而非 localhost/project，極大提升開發體驗並避免路徑相關 Bug。本文將手把手教你完成從 httpd.conf 修改到 hosts 綁定的全流程，並解決常見權限與路徑問題。

前置條件

• 已安裝 Apache（如 XAMPP、WAMP 或獨立安裝）
• 具備管理員權限（修改系統 hosts 檔案需要）
• 確認 Apache 安裝目錄，本文以 D:/Apache 為例

步驟一：編輯 httpd.conf 啟用虛擬主機

1. 打開 D:/Apache/conf/httpd.conf（路徑視安裝位置而定）。
2. 搜尋 #Include conf/extra/httpd-vhosts.conf，移除行首 # 啟用虛擬主機配置檔分離（推薦）。或直接在檔案末尾新增配置區塊。
3. 在檔案末尾加入以下配置：

<VirtualHost *:80>
    ServerName www.mydemo.com
    DocumentRoot "D:/mydemo"
    <Directory "D:/mydemo">
        Options FollowSymLinks IncludesNOEXEC Indexes
        DirectoryIndex index.html index.htm default.htm index.php default.php index.cgi default.cgi index.pl default.pl index.shtml
        AllowOverride Options FileInfo
        Require all granted
    </Directory>
</VirtualHost>

關鍵指令說明：

• ServerName：瀏覽器訪問的域名，需與 hosts 一致。
• DocumentRoot：網站根目錄絕對路徑，使用正斜線 / 避免轉義問題。
• AllowOverride Options FileInfo：允許 .htaccess 覆蓋重寫規則等，框架專案必備。
• Require all granted：Apache 2.4+ 授權語法，舊版為 Order Allow,Deny / Allow from all。

步驟二：修改系統 hosts 檔案綁定域名

1. 以管理員身分開啟記事本，載入 C:\Windows\System32\drivers\etc\hosts。
2. 在檔案末尾新增：

127.0.0.1 www.mydemo.com

保存後，在命令提示字元執行 ipconfig /flushdns 刷新 DNS 快取。

步驟三：建立專案目錄與測試檔案

mkdir D:\mydemo
echo "<?php phpinfo(); ?>" > D:\mydemo\index.php

步驟四：重啟 Apache 並驗證

• XAMPP/WAMP：控制面板點擊 Restart。
• 獨立安裝：httpd -k restart 或服務管理器重啟。

瀏覽器訪問 https://www.mydemo.com，應顯示 PHP 資訊頁，代表配置成功。

常見問題排查

進階技巧：多站點與通配符域名

若需同時運行多個專案，只需在 httpd-vhosts.conf 中新增多個 <VirtualHost> 區塊，並同步更新 hosts。開發階段亦可使用 *.test 通配符搭配 dnsmasq 或 Acrylic DNS Proxy 實現自動解析，免去逐個手動添加。

總結

掌握 Windows 下 Apache 虛擬主機配置，能讓本地開發環境更貼近線上生產環境，減少部署時的路徑、Cookie 域名、重寫規則等差異導致的問題。建議將常用配置封裝為腳本或 Ansible Playbook，新機器一鍵佈署。