©
本文档使用
php.cn手册 发布
当入口脚本在调用 yii\web\Application::run() 方法时,它进行的第一个操作就是解析输入的请求,然后实例化对应的控制器操作处理这个请求。该过程就被称为引导路由(routing)。(译注:中文里既是动词也是名词)
路由引导的第一步,是把传入请求解析为一个路由。如我们在 控制器(Controllers) 章节中所描述的那样,路由是一个用于定位控制器操作的地址。这个过程通过 request
应用组件的 yii\web\Request::resolve() 方法实现,该方法会调用 URL 管理器 进行实质上的请求解析工作。
默认情况下,传入请求会包含一个名为 r
的 GET
参数,它的值即被视为路由。但是如果启用 yii\web\UrlManager::enablePrettyUrl,那么在确定请求的路由时,就会进行更多处理。具体的细节请参考 URL 的解析与生成 章节。
假使某路由最终实在无法被确定,那么 request
组件会抛出 yii\web\NotFoundHttpException 异常(译注:大名鼎鼎的 404)。
如果传入请求并没有提供一个具体的路由,(一般这种情况多为于对首页的请求)此时就会启用由 yii\web\Application::defaultRoute 属性所指定的缺省路由。该属性的默认值为 site/index
,它指向 site
控制器的 index
操作。你可以像这样在应用配置中调整该属性的值:
return [
// ...
'defaultRoute' => 'main/index',
];
catchAll
路由(全拦截路由)有时候,你会想要将你的 Web 应用临时调整到维护模式,所有的请求下都会显示相同的信息页。当然,要实现这一点有很多种方法。这里面最简单快捷的方法就是在应用配置中设置下 yii\web\Application::catchAll 属性:
return [
// ...
'catchAll' => ['site/offline'],
];
catchAll
属性需要传入一个数组做参数,该数组的第一个元素为路由,剩下的元素会(以名值对的形式)指定绑定于该操作的各个参数。
当设置了 catchAll
属性时,它会替换掉所有从输入的请求中解析出来的路由。如果是上文的这种设置,用于处理所有传入请求的操作都会是相同的 site/offline
。
一旦请求路由被确定了,紧接着的步骤就是创建一个“操作(action)”对象,用以响应该路由。
路由可以用里面的斜杠分割成多个组成片段,举个栗子,site/index
可以分解为 site
和 index
两部分。每个片段都是指向某一模块(Module)、控制器(Controller)或操作(action)的 ID。
从路由的首个片段开始,应用会经过以下流程依次创建模块(如果有),控制器,以及操作: