萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Windows 下 Apache + PHP 配置虛擬目錄完整步驟

環境假設

  • Apache 安裝目錄:D:\Apache24
  • 專案目錄:D:\myproject
  • 欲綁定網域:www.myproject.local

步驟 1:修改 Apache httpd.conf

檔案:D:\Apache24\conf\httpd.conf


# 1. 確保載入虛擬主機模組 (預設已開啟)
LoadModule vhost_alias_module modules/mod_vhost_alias.so
Include conf/extra/httpd-vhosts.conf

# 2. 在檔案末尾新增虛擬主機配置
<VirtualHost *:80>
    ServerName www.myproject.local
    ServerAlias myproject.local
    DocumentRoot "D:/myproject/public"
    
    <Directory "D:/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>

步驟 2:修改 Windows 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

步驟 3:建立專案目錄與測試檔案


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

步驟 4:重啟 Apache 並驗證

  1. 命令列:httpd -k restart 或服務管理器重啟
  2. 瀏覽器訪問:https://www.myproject.local/
  3. 應顯示 phpinfo() 頁面

常見問題排查

現象可能原因解決
403 ForbiddenDirectory 權限未設 Require all granted檢查 <Directory> 區塊
404 Not FoundDocumentRoot 路徑錯誤或不存在確認路徑大小寫、實際存在
無法訪問網域Hosts 檔案未生效、DNS 快取ipconfig /flushdns、檢查 hosts 格式
PHP 不執行未載入 php_module、副檔名未關聯檢查 httpd.conf PHP 載入區塊
.htaccess 不生效AllowOverride None設為 AllowOverride All

進階:多站點管理最佳實務

  1. 建立 conf/vhosts/ 目錄,每站一個 .conf
  2. httpd.conf 包含:IncludeOptional conf/vhosts/*.conf
  3. 專案獨立配置,互不干擾,易於版控

Laravel / Symfony 等框架特殊設定


<VirtualHost *:80>
    ServerName laravel.local
    DocumentRoot "D:/projects/laravel/public"  # 指向 public 目錄
    
    <Directory "D:/projects/laravel/public">
        AllowOverride All
        Require all granted
        
        # 前端控制器模式:不存在檔案導向 index.php
        FallbackResource /index.php
        # 或傳統 Rewrite
        # RewriteEngine On
        # RewriteCond %{REQUEST_FILENAME} !-f
        # RewriteCond %{REQUEST_FILENAME} !-d
        # RewriteRule ^ index.php [L]
    </Directory>
</VirtualHost>
copyright © 萬盛學電腦網 all rights reserved