Yii2后台无urlManager数组时如何配置管理路由？

当前后台路由逻辑说明 #

你提到后台未在/common/config/*或/backend/config/*中配置路由，说明它目前使用Yii2的默认路由机制：请求URL直接映射为控制器ID/操作ID，比如访问https://admin.example.com/supplier/list，会自动对应backend/controllers/SupplierController.php里的actionList方法，无需额外规则配置。

添加自定义路由规则的步骤 #

如果需要自定义URL（如缩短路径、隐藏控制器名等），按以下操作执行：

1. 编辑后台核心配置文件 #

打开backend/config/main.php，找到components数组，添加或完善urlManager组件配置：

return [
    // 其他原有配置
    'components' => [
        // 其他原有组件
        'urlManager' => [
            'enablePrettyUrl' => true, // 开启URL美化，移除index.php
            'showScriptName' => false, // 隐藏URL中的index.php
            'rules' => [
                // 自定义路由规则示例
                // 示例1：将/supplier-report映射到SupplierController的actionUserAccessReport
                'supplier-report' => 'supplier/user-access-report',
                // 示例2：带参数的路由，/supplier/123/detail对应SupplierController的actionViewDetail，参数id=123
                'supplier/<id:\d+>/detail' => 'supplier/view-detail',
                // 示例3：新增控制器的路由，如ReportController的index操作
                'reports' => 'report/index',
            ],
        ],
    ],
];

注：如果你的环境使用main-local.php（如开发环境），可将路由规则添加到该文件中，避免覆盖提交到版本库的基础配置。

2. 确认Nginx转发配置正确 #

由于后台部署在子域名下，检查nginx/backend配置文件，确保请求能正确转发到后台入口：

server {
    server_name admin.yourdomain.com;
    root /path/to/your/project/backend/web;
    index index.php;

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

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000; // 根据你的服务器/容器配置调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

该配置会让Nginx将所有子域名请求转发到backend/web/index.php，配合Yii2的urlManager实现美化URL。

3. 验证路由有效性 #

添加规则后，删除backend/runtime/cache下的缓存文件，然后访问自定义URL（如https://admin.example.com/supplier-report），确认是否能正确对应到目标控制器的操作方法。

额外注意事项 #

• Yii2路由规则按从上到下的顺序匹配，优先级高的规则需放在前面。
• 后台路由建议单独在backend/config中配置，避免与前端路由混淆，保持前后端分离的架构清晰。
• 若通过Gii生成CRUD，可自动生成基础路由规则，手动调整时遵循上述配置逻辑即可。

内容的提问来源于stack exchange，提问作者Farid