Windows Apache 配置虛擬主機完整步驟：httpd.conf、hosts、目錄權限與驗證

在 Windows 開發環境為每個專案配置獨立域名（如 www.myproject.local），需修改 Apache httpd.conf 啟用虛擬主機、設定 DocumentRoot、目錄權限，並編輯系統 hosts 檔案解析域名。本文提供標準化步驟與常見錯誤排查。

1. 編輯 Apache httpd.conf

檔案位置：C:\Apache24\conf\httpd.conf (視安裝路徑調整)

步驟 A：確認模組載入

# 搜尋並取消註解 (去掉 #)
LoadModule vhost_alias_module modules/mod_vhost_alias.so
# 確認已載入
LoadModule rewrite_module modules/mod_rewrite.so

步驟 B：啟用虛擬主機配置檔 (推薦分離管理)

# 取消註解
Include conf/extra/httpd-vhosts.conf

步驟 C：編輯 conf/extra/httpd-vhosts.conf 新增虛擬主機

<VirtualHost *:80>
    ServerName www.myproject.local
    ServerAlias myproject.local
    DocumentRoot "D:/Projects/myproject/public"
    <Directory "D:/Projects/myproject/public">
        Options Indexes FollowSymLinks Includes ExecCGI
        AllowOverride All
        Require all granted
    </Directory>
    # 可選：獨立錯誤/存取日誌
    ErrorLog "logs/myproject-error.log"
    CustomLog "logs/myproject-access.log" common
</VirtualHost>

關鍵指令說明：

• ServerName：主域名，瀏覽器訪問時匹配。
• DocumentRoot：專案公開目錄（如 Laravel public/、Symfony public/、ThinkPHP public/）。
• AllowOverride All：允許 .htaccess 覆蓋（框架路由重寫必須）。
• Require all granted：Apache 2.4+ 權限寫法，舊版為 Order allow,deny / Allow from all。

2. 編輯系統 hosts 檔案

路徑：C:\Windows\System32\drivers\etc\hosts

• 需**管理員權限**開啟（記事本右鍵「以系統管理員身分執行」）。
• 在檔案末尾新增：

127.0.0.1       www.myproject.local
127.0.0.1       myproject.local
::1             www.myproject.local

注意：IPv6 ::1 同步加入，避免瀏覽器優先解析 IPv6 導致連線失敗。

3. 建立專案目錄與測試檔案

# 在 D:/Projects/myproject/public 建立 index.php
<?php
echo "Virtual Host Works! " . date('Y-m-d H:i:s');
phpinfo();

4. 重啟 Apache 並驗證

# 命令列 (以管理員執行)
httpd -k restart
# 或 Windows 服務管理器重啟 Apache2.4 服務

瀏覽器訪問：https://www.myproject.local/ 應顯示測試頁面。

5. 常見問題排查清單

6. 進階：批次建立虛擬主機 (開發多專案)

若專案眾多，可啟用 mod_vhost_alias 動態映射：

<VirtualHost *:80>
    ServerName dev.local
    ServerAlias *.dev.local
    VirtualDocumentRoot "D:/Projects/%1/public"
    <Directory "D:/Projects/*/public">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

配合 hosts：

127.0.0.1   project1.dev.local
127.0.0.1   project2.dev.local
# 之後新增專案只需建立資料夾 D:/Projects/project3/public，無需改 Apache 設定

%1 代表域名第一段 (project1, project2...)。

7. HTTPS 本地開發 (mkcert)

# 安裝 mkcert (Go 編譯的單一執行檔)
mkcert -install
mkcert myproject.local "*.myproject.local" localhost 127.0.0.1 ::1

# 產生 myproject.local.pem + myproject.local-key.pem
# httpd-vhosts.conf 新增 443 埠 VirtualHost
<VirtualHost *:443>
    ServerName www.myproject.local
    DocumentRoot "D:/Projects/myproject/public"
    SSLEngine on
    SSLCertificateFile "C:/certs/myproject.local.pem"
    SSLCertificateKeyFile "C:/certs/myproject.local-key.pem"
    <Directory ...> ... </Directory>
</VirtualHost>