yii2项目实战-路由美化以及如何正确的生成链接
美化路由
何为美化路由呢?美化嘛,无外乎就是给路由化化妆,让她好看点。我虽没化过妆,那好歹也是见过描描眉的。下面我们就来看看如何给你的路由添加添加点“颜色”的。
yii的路由美化工作,全权由urlManager组件负责。默认情况下,该组件并没有开启。
我们在配置文件backend\config\main.php中简单配置下该组件
'urlManager' => [ 'enablePrettyUrl' => false, 'showScriptName' => true, 'enableStrictParsing' => false, 'suffix' => '', 'rules' => [ ], ],
按照我们上文的配置,你可能看不到当前路由有什么变化,我们来做几个小例子分别讲述下要介绍的这几个参数
enablePrettyUrl:是否开启美化效果
我们把false改为true前后,分别访问下左侧的“博客”菜单项,前后对比如下:
false:/index.php?r=blog%2Findex true:/index.php/blog/index
这效果感觉跟开了美颜相机似的。
showScriptName:是否或略脚本名index.php
就上面的链接而言,大多数情况下我们并不想展示index.php,我们更想要的是/blog/index效果,这个时候showScriptName的作用就显现出来了
不过该参数还需要我们配置web服务器如apache和nginx,为了更详细的说明,我们准备单独写篇文章说说。
enableStrictParsing:是否开启严格解析路由
什么意思呢?假设我们在开启了路由美化的功能(enablePrettyUrl设置为true),enableStrictParsing设置为false的情况下,我们直接访问/index.php/blog/index肯定是没有问题的。但是如果我们直接访问/index.php?r=blog%2Findex呢?发现页面展示的效果是/site/index(实际上这里展示的默认的路由页面),并非是博客列表页面。如果我们把enableStrictParsing参数设置为true你会发现页面直接抛出404。因为这货设置为true之后,会匹配rules选项中设定的至少一个规则,那我们这里先设置一个路由,不然没法继续了。
'rules' => [ "<controller:\w+>/<action:\w+>"=>"<controller>/<action>", ],
此时刷新下/index.php/blog/index就正常了。
rules:包含了路由的匹配规则列表
也就是说,如果我们要定制特殊的路由,就需要通过这个属性进行配置。
rules包含着我们配置的路由规则列表,当解析一个路由或者生成一个路由的时候,匹配规则的顺序是从第一条规则开始,知道匹配到第一个满足的为止。
我们来说一下rules的每一项的规则,以/blogs为例,当然这是一个不存在的路由,你可以访问下试试会不会抛出404异常。
我们在rules的第一项添加,现在我们的rules是下面这样的
'rules' => [ '/blogs' => '/blog/index', "<controller:\w+>/<action:\w+>"=>"<controller>/<action>", ],
这其实就是把我们访问的/blogs路由映射到/blog/index路由上面了,所以我们访问/blogs才得以被解析并能正常访问/blog/index页面。
我们再举一个例子,如果我们要求访问/blogs/1可以展示/blog/view?id=1这个界面呢?
实际上/blog/view?id=1需要一个参数是id,我们可以这样做一个映射
'/blogs/<id:\d+>' => '/blog/view',
可以自行体会一下。
但是,如果我们的项目要求所有的路由都这样被解析,每一个都这样写rules岂不是很庞大很复杂?
rules不只支持正则匹配,我们还可以配置controller和action匹配所有满足的路由。比如我们在开启enableStrictParsing为true后,设置的
"<controller:\w+>/<action:\w+>"=>"<controller>/<action>",
再比如如果我们想要所有的controller/id映射到controller/view界面,我们可以这样配置
'rules' => [ '/blogs' => '/blog/index', // '/blogs/<id:\d+>' => '/blog/view', '<controller:\w+>/<id:\d+>' => '<controller>/view', "<controller:\w+>/<action:\w+>"=>"<controller>/<action>", ],
此时我们访问 /index.php/blog/1 会正常显示/blog/view?id=1这个界面。
suffix:url后缀
有时候我们想要访问的页面都带上.html后缀,这个时候只需要简单的配置suffix参数即可
'suffix' => '.html',
如果我们此时在访问/index.php/blog/index恐怕是不可以的,因为我们已经要求所有的url后缀都要带上.html才可以被正常解析!即只有访问 /index.php/blog/index.html 才是可以的。
urlManager的匹配规则我们掌握了,但是!整个网站的链接是要我们手动写的,难不成你天天修改规则,我还要天天修改链接的写法吗?这简直就是一场“灾难”!
举一个例子,由于网站前期并没有考虑页
还有52%的精彩内容,购买继续阅读
- 评论区