萬盛學電腦網

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

Yii 2 移除 index.php:Nginx/Apache 重寫規則完整配置

目標

將 URL 從 https://example.com/index.php?r=site/index 簡化為 https://example.com/site/index。

前置條件

  • Yii 2 應用結構:web/index.php 為入口
  • Web 伺服器文檔根目錄指向 web/
  • 啟用 urlManager.enablePrettyUrl = true、showScriptName = false

Nginx 配置

server {
    listen 80;
    server_name example.com;
    root /var/www/yii2/web; # 指向 web 目錄
    index index.php;

    location / {
        # 嘗試直接服務檔案,否則導向 index.php
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 或 127.0.0.1:9000
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_intercept_errors on;
    }

    # 安全:隱藏隱藏檔、版本控制目錄
    location ~ /\.(htaccess|htpasswd|git|svn) {
        deny all;
    }
}

Apache (.htaccess) 配置

放置於 web/.htaccess:

RewriteEngine On

# 如果請求是實際存在的檔案/目錄,直接服務
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 否則導向 index.php 保留查詢字串
RewriteRule ^(.*)$ index.php [L,QSA]

# 安全:禁止存取隱藏檔

    Order allow,deny
    Deny from all


# 可選:強制 HTTPS
# RewriteCond %{HTTPS} off
# RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Yii 2 設定 (config/web.php)

return [
    'components' => [
        'request' => [
            'baseUrl' => '', // 關鍵:移除腳本名稱前綴
        ],
        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'enableStrictParsing' => false,
            'rules' => [
                '' => 'site/index',
                '/' => '/',
                '//' => '//',
                // RESTful API
                ['class' => 'yii\rest\UrlRule', 'controller' => 'user'],
            ],
        ],
    ],
];

常見問題排查

現象原因解決
404 Not FoundNginx 未正確傳遞 SCRIPT_FILENAME確認 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
無限重定向rewrite 規則錯誤導向自身檢查 try_files 順序、去除多餘 rewrite
CSS/JS/圖片 404root 指向錯誤目錄root 必須指向 web/ 目錄
參數丟失QSA 旗標缺失RewriteRule 加 [QSA]

子目錄部署 (如 /yii2/)

location /yii2/ {
    alias /var/www/yii2/web/; # 必須用 alias 並以 / 結尾
    try_files $uri $uri/ /yii2/index.php$is_args$args;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $request_filename; # alias 時用 $request_filename
        include fastcgi_params;
    }
}
copyright © 萬盛學電腦網 all rights reserved