XAMPP 配置乾淨 URL：啟用 Apache mod_rewrite 實現 Drupal/Ubercart 路由重寫

環境與目標

• 環境：XAMPP + Windows Vista + Drupal 5.x / Ubercart
• 目標：啟用 Clean URLs（移除 ?q= 參數）

核心步驟

1. 啟用 mod_rewrite 模組

編輯 F:\xampp\apache\conf\httpd.conf，找到並取消註解：

LoadModule rewrite_module modules/mod_rewrite.so

2. 建立專案專用虛擬主機配置

於 F:\xampp\apache\conf\extra\ 新建 httpd-ubercart-5.conf：

Alias /ubercart-5 "F:/xampp/htdocs/ubercart-5/"

<Directory "F:/xampp/htdocs/ubercart-5/">
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>

關鍵點： AllowOverride All 允許 .htaccess 覆寫重寫規則。

3. 重啟 Apache 生效

XAMPP 控制台重啟 Apache，或執行 xampp_restart.exe。

驗證方式

瀏覽器存取 https://localhost/ubercart-5/，Drupal 管理後台 admin/settings/clean-urls 應顯示「Clean URLs 測試通過」，可正常啟用。

避坑提醒

• 路徑分隔符統一使用正斜線 /，即使 Windows 環境
• 專案目錄名稱勿含空格、中文、特殊字元
• 若仍失效，檢查 .htaccess 是否存在且包含 Drupal 標準重寫規則