無羈

关于Yii2 配置文件中路由规则的使用说明 (基于yii2.0.12)

看到挺多同学在问URL路由规则的问题，本人之前也踩过些坑，所以感觉有必要整理一下，方便后来者

PS: 首先明确一下，请确保你的框架版本 >=2.0.12，老版本在URL生成逻辑中存在一些bug。

如果你的项目不方便直接更新框架版本，可以单独更新  vendor/yiisoft/yii2/web/UrlRule.php  文件。

详细的可以查看 `yii\web\UrlRule` 类的源码 

@see github.com/yiisoft/yii2/issues/10970

另外网上大部分问答，似乎都是在重复官方文档中的配置说明，不解决实际问题。所以重新整理还是有必要的，也希望各位看官能有所收获。

 回到正题，关于url rule的配置及使用 

配置代码段

//...
        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'cache' => YII_DEBUG ? false : 'cache',
            'suffix' => '.html',
            'rules' => [
                'pattern' => 'route', //写法1
                [
                    'class' => 'yii\web\UrlRule',//非必要
                    'pattern' => '',
                    'route' => '',
                    'suffix' => '.do',// 优先级高
                    //...其它
                ], //写法2
                //...
            ],
        ],

如上，常见的rule配置有两种方式:
1、  `'pattern' => 'route'` 的形式
2、  数组的形式，如果数组中不指定使用的类， 默认即是： ` yii\web\UrlRule::class `

下面咱们分开阐述一下这两种方式的使用

//方式1
//适合一些比较简单的路由规则设置，但是如果出现可选参数，可以采用 配置多条规则的方式解决。
//例如，规则如下
'site/test-<a:\w+>-<b:\w+>' => 'site/index',
'site/test-<b:\w+>' => 'site/index',

//测试
echo Url::to(['site/index', 'b'=>'bvalue']); 
//输出  /site/test-bvalue.html 
//... 
//其它同理

当然，如果你的参数比较多，建太多规则显然是不合适的。
另外就是这种多规则并存使用，容易出现混乱。

//假设我定义3条规则
'site/test-<a:\w+>-<b:\w+>' => 'site/index',
'site/test-<b:\w+>' => 'site/index',
'site/test-<a:\w+>' => 'site/index',

//那么在我访问  /site/test-value.html  的时候
// 这个  value 是a的值还是b的值呢？
//为了避免这种问题， 就可能需要把规则修改为如下配置

'site/test-a<a:\w+>-b<b:\w+>' => 'site/index',
'site/test-b<b:\w+>' => 'site/index',
'site/test-a<a:\w+>' => 'site/index',

所以，个人建议在出现多参数，或者参数为可选时，使用数组的形式进行配置。
下面我们看下数组的配置用例

//沿用 上述例子, 注意  这时候  我们只定义下面一个路由规则
[
    'pattern' => 'site/test-<a:\w+>-<b:\w+>',
    'route' => 'site/index',
],
//先看看 
echo Url::to(['site/index','b' => 'bvalue']);
//输出   /site/index.html?b=bvalue
//变成了 带问号的 get传参形式， 这当然不是我们想要的。

//调整rule配置，如下
 [
    'pattern' => 'site/test-<a:\w+>-<b:\w+>',
    'route' => 'site/index',
    'defaults' => [ //默认值
        'a' => '', //只能是 空字符串
    ],
],
//新增了 参数默认值的配置
//重新测试  输出  /site/test--bvalue.html 

//到这边其实已经满足了我们的基础需求， 但还是不完善的

为什么不完善呢？ 可能你也注意到了，上述 样例配置中 `//只能是 空字符串` 的注释说明.

截止到目前的官方版本，其它默认值还是不支持的。

比如我修改 a 的默认值为 avalue ， 测试结果并不是 ` /site/test-avalue-bvalue.html `
而是回到了 ` /site/index.html?b=bvalue ` 的状态

这也不是我想看到的结果， 我可能想把 a 的默认值设置为各种 类似 0 - 9 一些约定的 string等等。

那该如何解决呢？

这时候就比较费劲了， 需要修改框架的核心代码，或者扩展自定义一下。
当然个人建议是  继承后做自定义修改。
操作的具体过程我就不赘述了，请确认你知道如何自定义一个组件类，并能理解配置中指定某个组件类的原理。

核心操作说明：
修改`yii\web\UrlRule` 中 `createUrl` 方法中 490行附近的代码逻辑
```
//逻辑流程前有如下的 源码注释，可以参考 进行搜索
        // match default params
        // if a default param is not in the route pattern, its value must also be matched
```
 也可以参考我修改的类
 https://github.com/JeanWolf/plat/blob/master/common/core/UrlRuleWeb.php 

测试样例如下：

//rule 样例配置
[
    'class' => UrlRuleWeb::class,
    'pattern' => 'site/test-<aa:\d+>-<bb:\d+>-<cc:\d+>',
    'route' => 'site/index',
    'suffix' => '.do', //自定义后缀 可选配置
    'defaults' => [
        'aa' => 2,
        'bb' => '0',
    ],
],

//测试
echo Url::to(['site/index', 'cc' => 3]);
//输出 /site/test-2-0-3.do 

完。

手动测试排版，如有纰漏，欢迎指正。