Windows 10 搭建 PHP 7 + Apache 2.4 開發環境完整圖文教程

環境準備與版本匹配原則

• 作業系統：Windows 10 (64 位)
• PHP 版本：PHP 7.x (VC14 編譯，僅提供 x64 Non Thread Safe / Thread Safe 兩種)
• Apache 版本：Apache 2.4.x (必須為 VC14 編譯版本，與 PHP 編譯器版本一致)
• 關鍵原則：位數 (x86/x64) + VC 版本 (VC11/VC14/VC15) + 線程安全 (TS/NTS) 三者必須完全匹配，否則會出現「無法加載模塊」、「Class not found」等詭異錯誤。

第一步：安裝配置 Apache 2.4

1.1 下載與解壓

• 官網無 Windows 二進制，前往 Apache Lounge 下載 httpd-2.4.x-win64-VC14.zip。
• 解壓至任意目錄，如 D:\Dev\Apache24。

1.2 修改 httpd.conf 核心配置

打開 D:\Dev\Apache24\conf\httpd.conf，修改以下關鍵項：

# 1. 服務器根目錄 (第 37 行左右)
ServerRoot "D:/Dev/Apache24"

# 2. 監聽端口 (第 58 行)
Listen 8080

# 3. 文檔根目錄 (第 226, 227 行)
DocumentRoot "D:/Dev/www"
<Directory "D:/Dev/www">

# 4. 默認首頁文件 (第 274 行)
DirectoryIndex index.html index.php

# 5. 啟用 rewrite 模塊 (第 159 行，去掉 #)
LoadModule rewrite_module modules/mod_rewrite.so

# 6. 允許 .htaccess 覆蓋 (第 242 行)
AllowOverride All

1.3 安裝為系統服務

以管理員身份打開 CMD/PowerShell：

cd /d D:\Dev\Apache24\bin
httpd.exe -k install -n "Apache2.4_PHP7"
# 啟動服務
net start "Apache2.4_PHP7"
# 或直接運行調試模式
httpd.exe

瀏覽器訪問 https://localhost:8080，見到 "It works!" 表示 Apache 運行正常。

第二步：安裝配置 PHP 7

2.1 下載與解壓

• 前往 PHP for Windows 下載 VC14 x64 Thread Safe 版 zip 包（Apache 模塊模式需 TS 版）。
• 解壓至 D:\Dev\PHP7。

2.2 配置 php.ini

1. 複製 php.ini-development 為 php.ini。
2. 核心修改項：

; 擴展目錄 (第 750 行左右) - 必須為絕對路徑
extension_dir = "D:/Dev/PHP7/ext"

; 常用擴展啟用 (去掉前分號)
extension=curl
extension=gd2
extension=mbstring
extension=mysqli
extension=pdo_mysql
extension=openssl
extension=xmlrpc

; 時區 (第 970 行)
date.timezone = Asia/Taipei

; 錯誤報告 (開發環境)
error_reporting = E_ALL
display_errors = On
log_errors = On
error_log = "D:/Dev/PHP7/logs/php_error.log"

; 會話存儲路徑
session.save_path = "D:/Dev/PHP7/sessiondata"

; 文件上傳
file_uploads = On
upload_max_filesize = 20M
post_max_size = 25M

創建對應目錄：logs、sessiondata。

2.3 整合 PHP 到 Apache

在 httpd.conf 末尾追加：

# 載入 PHP 模塊 (路徑指向 php7apache2_4.dll)
LoadModule php7_module "D:/Dev/PHP7/php7apache2_4.dll"

# 指定 PHP 配置文件目錄
PHPIniDir "D:/Dev/PHP7"

# 關聯 .php 文件類型
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>

# 可選：解析 .html 為 PHP
# AddType application/x-httpd-php .html

2.4 重啟 Apache 驗證

net stop "Apache2.4_PHP7"
net start "Apache2.4_PHP7"

在 D:\Dev\www 創建 phpinfo.php：

<?php phpinfo(); ?>

訪問 https://localhost:8080/phpinfo.php，查看 PHP 版本、載入模塊、配置路徑是否正確。

第三步：多站點/虛擬主機配置 (可選)

在 httpd.conf 引入獨立虛擬主機配置文件：

# httpd.conf 末尾
Include conf/extra/httpd-vhosts.conf

編輯 conf/extra/httpd-vhosts.conf：

<VirtualHost *:8080>
    ServerName project1.local
    DocumentRoot "D:/Dev/www/project1"
    <Directory "D:/Dev/www/project1">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog "logs/project1-error.log"
    CustomLog "logs/project1-access.log" common
</VirtualHost>

<VirtualHost *:8080>
    ServerName project2.local
    DocumentRoot "D:/Dev/www/project2"
    <Directory "D:/Dev/www/project2">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

修改 Windows hosts 文件 (C:\Windows\System32\drivers\etc\hosts)：

127.0.0.1   project1.local
127.0.0.1   project2.local

常見問題排查清單

生產環境部署差異提示

• 使用 php.ini-production 作為基礎，關閉 display_errors，開啟 opcache。
• Apache 使用 Event MPM + PHP-FPM (FastCGI) 替代 mod_php，獲得更好併發性能。
• 配置 SSL/TLS、安全頭、速率限制、訪問控制。
• 考慮使用 Docker 容器化部署，保證環境一致性。

按照本教程步驟操作，你將在 Windows 10 上擁有一個穩定、標準的 PHP 7 + Apache 2.4 開發環境，為後續框架學習、項目開發打下堅實基礎。