萬盛學電腦網

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

PHP + Apache 2.2 + Rewrite 靜態化配置完整教程

環境準備

  • OS: Windows / Linux
  • Apache 2.2.x
  • PHP 5.x (線程安全版 TS,對應 php5apache2_2.dll)
  • MySQL (可選)

Apache 配置 (httpd.conf)

1. 核心模塊載入

# 載入 PHP 模塊 (關鍵:必須用 php5apache2_2.dll,非 php5apache2.dll)
LoadModule php5_module "D:/php/php5apache2_2.dll"
AddType application/x-httpd-php .php
AddType application/x-httpd-php .htm
AddType application/x-httpd-php .html
# 可添加 .php3 .php4 .phtml 等

# 載入 Rewrite 模塊
LoadModule rewrite_module modules/mod_rewrite.so

2. 文檔根目錄與默認文檔

DocumentRoot "E:/Program Files/Apache Software Foundation/Apache2.2/htdocs"

    Options Indexes FollowSymLinks
    AllowOverride All  # 關鍵:允許 .htaccess 覆蓋
    Require all granted


DirectoryIndex index.html index.php index.htm

PHP 配置 (php.ini)

; 1. 擴展目錄
extension_dir = "D:/php/ext"

; 2. 常用擴展 (去掉分號啟用)
extension=php_mbstring.dll
extension=php_gd2.dll
extension=php_mysql.dll
extension=php_mysqli.dll
extension=php_pdo_mysql.dll
extension=php_curl.dll
extension=php_openssl.dll

; 3. Session 存儲路徑 (需創建目錄並給寫權限)
session.save_path = "D:/php/session_temp"

; 4. 錯誤報告 (開發環境)
display_errors = On
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT

; 5. 時區
date.timezone = Asia/Shanghai

URL Rewrite 靜態化規則

方案 A:虛擬主機配置 (httpd-vhosts.conf) - 推薦


    ServerName www.myshop.local
    DocumentRoot "E:/www/myshop"
    
    
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    
    
    # Rewrite 規則 (放在 VirtualHost 內或 .htaccess)
    RewriteEngine On
    RewriteBase /
    
    # 租房詳情
    RewriteRule ^rent/d-(\d+)\.html$ rent/detail.php?id=$1 [L,QSA]
    # 新房詳情
    RewriteRule ^newhouse/d-(\d+)\.html$ newhouse/detail.php?id=$1 [L,QSA]
    # 二手房詳情
    RewriteRule ^sale/d-(\d+)\.html$ sale/detail.php?id=$1 [L,QSA]
    # 店鋪
    RewriteRule ^shop/(\d+)/?$ shop/profile.php?id=$1 [L,QSA]
    RewriteRule ^shop/e-(\d+)\.html$ shop/evaluate.php?id=$1 [L,QSA]
    RewriteRule ^shop/p-(\d+)\.html$ shop/profile.php?id=$1 [L,QSA]
    # 小區
    RewriteRule ^community/g-(\d+)\.html$ community/general.php?id=$1 [L,QSA]
    RewriteRule ^community/p-(\d+)\.html$ community/photo.php?id=$1 [L,QSA]
    RewriteRule ^community/e-(\d+)\.html$ community/edit.php?id=$1 [L,QSA]
    # 新房戶型/相冊
    RewriteRule ^newhouse/s-(\d+)\.html$ newhouse/structure.php?id=$1 [L,QSA]
    RewriteRule ^newhouse/p-(\d+)\.html$ newhouse/photo.php?id=$1 [L,QSA]

方案 B:.htaccess (共享主機/目錄級)

# .htaccess 放在 DocumentRoot
RewriteEngine On
RewriteBase /

# 防止對真實文件/目錄重寫
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 通用規則示例
RewriteRule ^article/(\d+)\.html$ article.php?id=$1 [L]
RewriteRule ^category/(\w+)/?$ category.php?slug=$1 [L]

# 前端控制器模式 (框架通用)
RewriteRule ^(.*)$ index.php?route=$1 [L,QSA]

Rewrite 規則標誌位說明

標誌含義
L (Last)停止後續規則匹配
QSA (QueryStringAppend)合並原查詢字符串 (如 ?page=2)
NC (NoCase)忽略大小寫
R[=code] (Redirect)外部重定向,瀏覽器地址欄變化
F (Forbidden)返回 403

Windows 系統 DLL 依賴修復

常見錯誤:Cannot load php5apache2_2.dll / php5ts.dll 丟失

  1. 將 php5ts.dll, libmysql.dll (或 libmysqli.dll) 複製到 Apache bin 目錄 或 系統目錄 (C:\Windows\System32)。
  2. 安裝 Visual C++ Redistributable (VC6 for PHP 5.2, VC9 for PHP 5.3+, VC11 for PHP 5.5+, VC14 for PHP 7+)。
  3. 確認 Apache 與 PHP 線程模型一致:Apache 2.2 + PHP TS (Thread Safe)。

驗證安裝

<?php
// htdocs/test.php
phpinfo();
?>

訪問 https://localhost/test.php,檢查:

  • PHP Version
  • Loaded Configuration File (確認讀取正確 php.ini)
  • Apache 2.0 Handler (確認模塊加載)
  • MySQLi / PDO_MySQL / GD / cURL / mbstring 等擴展

常見問題排查

現象原因解決
顯示源碼 / 下載文件AddType 未生效 / 模塊未載入檢查 LoadModule、AddType、重啟 Apache
404 Not Found (Rewrite)AllowOverride None / 模塊未載入 / 規則錯誤設 AllowOverride All、LoadModule rewrite_module、檢查正則
500 Internal Server Error語法錯誤、.htaccess 錯誤、權限查 Apache error.log、php_error.log
中文亂碼編碼不一致php.ini: default_charset=UTF-8; HTML: ; DB: SET NAMES utf8mb4

總結

Apache 2.2 + PHP 5.x 經典部署棧,核心在於:正確載入 TS 版 PHP 模塊、啟用 Rewrite、配置 AllowOverride、設置時區與擴展。現代項目建議遷移至 PHP 8.x + Apache 2.4 (event MPM) / Nginx + PHP-FPM,獲得更高性能、安全性與長期支援。

copyright © 萬盛學電腦網 all rights reserved