啟用Yii的URL重寫需完成四個步驟。首先在配置文件中設置urlManager，啟用enablePrettyUrl並隱藏index.php；其次若使用Apache，需配置.htaccess文件以啟用URL重寫；第三若使用Nginx，需修改server塊配置以正確轉發(fā)請求；最後進行測試並驗證是否成功移除index.php且訪問正常。

Enabling URL rewriting in Yii is a straightforward process, but it can trip you up if you miss one or two steps. The main goal is to make URLs cleaner and more user-friendly by removing index.php from the URL.

1. Configure urlManager in Yii config

The first step is to adjust the URL manager settings in your Yii configuration file ( config/web.php for Yii2 basic or advanced template).

You'll want to set 'urlFormat' => 'path' and enable 'enablePrettyUrl' => true . Here's what that part of your config should look like:

 'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // your custom rules go here
        ],
    ],
],

• enablePrettyUrl turns on pretty URLs.
• showScriptName set to false hides index.php from the URL.
• rules is where you define custom routes later on.

If you skip this step or misconfigure it, your URLs will still work but won't be clean.

2. Set up .htaccess for Apache

If you're using Apache , you need an .htaccess file in your web root (usually the web/ folder in Yii2 projects) to rewrite URLs properly.

Here's a standard .htaccess content:

 RewriteEngine on
# If a directory or a file exists, use it directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# Otherwise forward it to index.php
RewriteRule . index.php

This tells Apache to route all requests to index.php , unless the file or folder actually exists (like images, CSS, JS, etc.). Without this, even with the config changes, your site will return 404s when trying to access clean URLs.

Make sure mod_rewrite is enabled in Apache. You can check this by looking at your Apache config or running a2enmod rewrite on Linux systems.

3. Nginx users: update server block config

If you're using Nginx , you don't rely on .htaccess . Instead, you need to modify your Nginx server block configuration.

Here's a typical setup:

 server {
    listen 80;
    server_name example.com;
    root /path/to/your/yii2/web/;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php-fpm.sock;
    }
}

This makes sure any request not matching an actual file gets sent to index.php , which Yii uses to handle routing. If you skip this, you'll get 404 errors again, even though everything else seems configured right.

4. Test it out

Once you've made both config changes — in urlManager and either .htaccess or Nginx config — restart your server (if needed), then try visiting a page on your site without index.php in the URL.

For example:

• Before: http://example.com/index.php?r=site/about
• After: http://example.com/site/about

If it works, great! If not, double-check:

• That urlManager settings are correct.
• That .htaccess or Nginx config is properly applied.
• That mod_rewrite is enabled (for Apache).
• That your server has permission to read .htaccess .

It's not complicated, but there are enough moving parts that missing one thing can break the whole setup.

以上是如何在yii中啟用URL重寫？的詳細內容。更多資訊請關注PHP中文網(wǎng)其他相關文章！