從 WAMP 遷移到 XAMPP 完整配置指南

遷移背景

為學習 Laravel 框架（要求 PHP 5.4+），原 WAMP 內置 PHP 5.3 不滿足需求，決定遷移至 XAMPP。本文記錄完整遷移步驟與踩坑經驗，供類似場景參考。

遷移步驟

1. 卸載 WAMP 並備份關鍵數據

• 卸載 WAMP 會刪除其安裝目錄下的所有文件，包含 PHP 擴展、MySQL 數據目錄。
• 必備份：php/ext 下的擴展 DLL、mysql/data 數據庫文件、自定義 php.ini、httpd.conf、虛擬主機配置。

2. 下載安裝 XAMPP

官網：apachefriends.org，選擇對應 PHP 版本（建議 PHP 7.4+ 或 8.x）下載安裝包，一路默認安裝。

3. 啟動服務並驗證

打開 XAMPP Control Panel，啟動 Apache、MySQL，瀏覽器訪問 https://localhost 出現歡迎頁即成功。

4. 配置虛擬主機映射舊項目目錄

XAMPP 默認根目錄為 htdocs，舊 WAMP 項目在 D:/soft/wamp/www，需配置虛擬主機保持原有訪問路徑。

# httpd.conf 確保允許覆寫與訪問
<Directory />
    Options All
    AllowOverride All
    Require all granted
</Directory>

# httpd-vhosts.conf
NameVirtualHost *:80

<VirtualHost *:80>
    ServerAdmin webmaster@dummy-host.example.com
    DocumentRoot "D:/soft/xampp/htdocs"
    ServerName localhost
</VirtualHost>

<VirtualHost *:80>
    ServerAdmin webmaster@dummy-host.example.com
    DocumentRoot "D:/soft/wamp/www"
    ServerName vhallapp.com
    ServerAlias www.vhallapp.com
    ErrorLog "D:/soft/wamp/apacheerror.log"
    CustomLog "D:/soft/wamp/apacheaccess.log" common
</VirtualHost>

5. 修改 hosts 文件

127.0.0.1 www.app.com

6. 安裝 PHP 擴展

• Redis：從 PECL 下載對應 PHP 版本、TS/NTS、VC 編譯版本的 php_redis.dll 放入 php/ext。
• 編輯 php.ini 添加 extension=php_redis.dll。

7. 配置 Xdebug

[XDebug]
zend_extension = "D:\soft\xampp\php\ext\php_xdebug.dll"
xdebug.profiler_enable = 1
xdebug.profiler_output_dir = "D:\soft\xampp\tmp"
xdebug.remote_enable = 1
xdebug.remote_host = "127.0.0.1"
xdebug.remote_handler = "dbgp"
# 其他按需開啟

8. 重啟 Apache 驗證

瀏覽器訪問 https://www.app.com，項目正常運行則遷移完成。

遷移核心清單

常見問題

• 端口衝突：80/3306 被佔用 → 修改 httpd.conf Listen 或停用系統 IIS/Skype。
• PHP 版本不匹配：擴展 DLL 必須與 PHP 版本、線程安全性、VC 編譯版本完全一致。
• 權限問題：Windows 下確保 Apache 服務用戶對項目目錄有讀寫權限。

總結

WAMP → XAMPP 遷移核心在於 環境版本對齊 與 配置遷移。建議將配置文件、虛擬主機、擴展列表納入版本控制，未來遷移或團隊協作可一鍵復現環境。