15.4 隐藏入口文件index.php-Yii2框架从入门到精通(下)

当前位置:　首页>> 技术小册>> Yii2框架从入门到精通(下)

15.4 隐藏入口文件index.php

在Web开发中，尤其是在使用Yii2这类现代PHP框架时，保持URL的清洁和友好是提升用户体验和SEO性能的关键步骤之一。Yii2框架默认通过index.php文件作为应用的入口，但直接暴露这个入口文件往往会破坏URL的美感，让用户或搜索引擎感觉网站不够专业。因此，隐藏或美化index.php成为了一个常见的需求。本章节将详细介绍如何在Yii2中实现这一目的，包括使用Web服务器（如Apache、Nginx）的重写规则以及Yii2的URL美化配置。

15.4.1 理解URL重写

URL重写是Web服务器的一项功能，它允许服务器根据预定义的规则将输入的URL转换为另一个URL。在Yii2中，隐藏index.php通常是通过URL重写来实现的，这样用户请求的URL就不需要直接包含index.php，但仍然能被服务器正确地解析并路由到Yii2框架处理。

15.4.2 Apache服务器的配置

如果你使用的是Apache服务器，可以通过编辑.htaccess文件来启用URL重写。.htaccess文件是一个分布式的配置文件，允许你针对特定目录设置服务器配置指令。

启用mod_rewrite模块：
确保Apache的mod_rewrite模块已经启用。这通常在Apache的配置文件（如httpd.conf或apache2.conf）中通过LoadModule rewrite_module modules/mod_rewrite.so来启用。
创建或编辑.htaccess文件：
在Yii2应用的根目录下创建或编辑.htaccess文件，添加以下配置：
```
Options +FollowSymLinks
IndexIgnore */*
RewriteEngine On
# 如果请求的是真实存在的文件或目录，直接访问
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 重写所有请求到 index.php
RewriteRule . index.php
```
这段配置首先检查请求的URL是否对应到一个真实的文件或目录，如果不是，则将所有请求重写为index.php。这样，用户就可以通过不包含index.php的URL来访问你的应用了。

15.4.3 Nginx服务器的配置

对于使用Nginx作为Web服务器的用户，隐藏index.php同样需要修改服务器配置。这通常是通过编辑Nginx的配置文件（如nginx.conf或在站点特定的配置文件中）来实现的。

编辑Nginx配置文件：
在server块中，针对你的Yii2应用配置一个location块，并添加如下配置：
```
location / {
    try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据实际情况调整
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
```
这里，try_files指令首先尝试按请求的URI提供服务（如直接访问静态文件），如果找不到对应的文件或目录，则将请求转发到index.php，并带上原始的查询参数。

注意：fastcgi_pass的值（这里是unix:/var/run/php/php7.4-fpm.sock）应该根据你的PHP-FPM配置进行调整。

15.4.4 Yii2的URL管理配置

除了Web服务器的配置外，Yii2还提供了灵活的URL管理配置，允许你进一步美化URL。这主要通过web.php（或main.php，取决于你的应用结构）配置文件中的urlManager组件来实现。

启用美化URL：
在web.php配置文件中，确保urlManager组件被正确配置以启用美化URL（即URL中不包含index.php）：
```
'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // 自定义URL规则
        ],
    ],
    // 其他组件配置...
],
```
这里，enablePrettyUrl设置为true以启用美化URL，showScriptName设置为false来隐藏index.php。rules数组用于定义URL的自定义路由规则。
自定义URL规则：
在rules数组中，你可以定义一系列的URL重写规则，以匹配用户的输入并映射到相应的控制器和动作。这有助于进一步提高URL的可读性和友好性。