当前位置：网站首页 >平台公告 > yii2 nginx rewrite

yii2 nginx rewrite

2026-05-20 平台公告 1658

Yii2+Nginx重写实战指南：从URL美化到性能调优

在Yii2框架的生产环境部署中，Nginx的URL重写规则是提升用户体验、优化SEO和保障性能的关键环节。通过合理配置Nginx的rewrite指令与Yii2的urlManager，不仅能实现友好的URL结构，还能避免重复请求、减少服务器负载。本文将从基础配置到实战优化，系统讲解Yii2与Nginx重写的协作技巧。

一、为何需要Nginx重写？

Yii2默认的URL结构（如/index.php?r=controller/action）存在两个问题：一是URL冗长不美观，影响用户体验；二是直接暴露入口文件，增加安全风险。而Nginx的重写规则可将这些“非友好”URL转化为/controller/action等简洁形式，同时通过try_files等指令减少对PHP解析层的无效请求，提升性能。

二、Yii2与Nginx的协作基础

Yii2的urlManager组件负责路由解析，而Nginx重写则是HTTP请求进入PHP之前的“预处理层”。两者的协作逻辑如下：

Yii2层面：通过config/web.php的urlManager配置路由规则（如'enablePrettyUrl' => true），定义URL与控制器/动作的映射关系。
Nginx层面：通过location块和rewrite指令处理静态资源、隐藏入口文件、重定向错误页面等，最终将请求优雅地转发给Yii2。

三、核心场景与配置示例

1. 隐藏入口文件（最基础需求）

目标：将/index.php?r=post/view转化为/post/view。

Nginx配置：

location / {
    try_files $uri $uri/ /index.php?$args;  # 优先匹配静态资源，无则转发到index.php
}

关键解释：try_files $uri $uri/表示先检查是否存在请求的文件或目录，若不存在则通过/index.php?$args将请求交给PHP处理。$args保留原查询参数（如?id=1）。

Yii2配合配置：在config/web.php中启用伪静态：

'urlManager' => [
    'enablePrettyUrl' => true,
    'enableStrictParsing' => false,
    'showScriptName' => false,  # 隐藏index.php
    'enableCookieValidation' => true,
],

2. 伪静态与SEO优化

yii2 nginx rewrite

目标：将文章详情页/post/view?id=123转化为/article/123.html，提升搜索引擎抓取效率。

Nginx配置：

location /article/(\d+)\.html$ {
    rewrite ^/article/(\d+)\.html$ /index.php?r=post/view&id=$1 last;
}

关键解释：通过正则表达式(\d+)捕获文章ID，将.html后缀请求重定向到Yii2的post/view动作，并传递id参数。

Yii2配合配置：在urlManager中定义规则：

'urlManager' => [
    'enablePrettyUrl' => true,
    'rules' => [
        'article/<id:\d+>.html' => 'post/view',  # 匹配/article/123.html → post/view
    ],
],

3. 强制HTTPS与域名跳转

目标：将HTTP请求自动跳转至HTTPS，同时统一域名（如www与不带www的域名）。

Nginx配置：

server {
    listen 80;
    server_name www.example.com example.com;
    return 301 https://www.example.com$request_uri;  # HTTP强制跳转HTTPS

    # 隐藏入口文件（与基础场景一致）
    location / {
        try_files $uri $uri/ /index.php?$args;
    }
}

server {
    listen 443 ssl;
    server_name www.example.com;
    ssl_certificate /path/to/cert.pem;

    # 静态资源直接返回
    location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
        expires 1d;  # 缓存静态资源1天
        try_files $uri =404;
    }

    # 动态请求交给Yii2
    location / {
        try_files $uri $uri/ /index.php?$args;
    }
}

4. 错误页面与404重定向

目标：将404错误页面统一为/404，并隐藏PHP错误细节。

Nginx配置：

server {
    error_page 404 /404.html;  # 定义404页面路径
    location = /404.html {
        root /var/www/yii2app/web;  # 静态404页面
    }
    location / {
        try_files $uri $uri/ /index.php?$args;
    }
}