×
关于 Yii(About Yii)从 Yii 1.1 升级

入门(Getting Started)

安装 Yii运行应用第一次问候使用 Forms玩转 Databases用 Gii 生成代码更上一层楼(Looking Ahead)

应用结构

结构概述(Overview)入口脚本(Entry Scripts)应用(Applications)应用组件(Components)控制器(Controllers)模型(Models)视图(Views)模块(Modules)过滤器(Filters)小部件(Widgets)前端资源(Assets)扩展(Extensions)

请求处理

运行概述(Overview)引导(Bootstrapping)路由引导与创建 URL请求(Requests)响应(Responses)Sessions and Cookies错误处理(Handling Errors)日志(Logging)

关键概念(Key Concepts)

组件(Components)属性(Properties)事件(Events)行为(Behaviors)配置(Configurations)别名(Aliases)类自动加载(Class Autoloading)服务定位器(Service Locator)依赖注入容器

配合数据库工作

数据库访问(Data Access)查询生成器(Query Builder)活动记录(Active Record)数据库迁移(Migrations)SphinxRedisMongoDBElasticSearch

接收用户数据

创建表单(Creating Forms)输入验证(Validating Input)文件上传(Uploading Files)收集列表输入多模型同时输入在客户端扩展 ActiveForm

显示数据

格式化输出数据分页(Pagination)排序(Sorting)数据提供器(Data Providers)数据小部件(Data Widgets)操作客户端脚本主题(Theming)

安全(Security)

认证(Authentication)授权(Authorization)处理密码(Passwords)加密(Cryptography)客户端认证(Auth Clients)安全领域的最佳实践

缓存(Caching)

概述(Overview)数据缓存(Data Caching)片段缓存(Fragment Caching)分页缓存(Page Caching)HTTP 缓存(HTTP Caching)

RESTful Web 服务

快速入门(Quick Start)资源(Resources)控制器(Controllers)路由(Routing)格式化响应(Response Formatting)授权验证(Authentication)速率限制(Rate Limiting)版本化(Versioning)错误处理(Error Handling)

开发工具

调试工具栏和调试器使用 Gii 生成代码TBD 生成 API 文档

测试(Testing)

概述(Overview)搭建测试环境单元测试(Unit Tests)功能测试(Functional Tests)验收测试(Acceptance Tests)测试夹具(Fixtures)

高级专题(Special Topics)

高级应用模版从头构建自定义模版控制台命令核心验证器(Core Validators)Docker国际化(Internationalization)收发邮件(Mailing)性能优化共享主机环境模板引擎集成第三方代码使用 Yii 作为微框架

小部件(Widgets)

Bootstrap 小部件jQuery UI 小部件

助手类(Helpers)

助手一览(Overview)Array 助手(ArrayHelper)Html 助手(Html)Url 助手(Url)

路由引导与创建 URL(Routing and URL Creation)


入口脚本在调用 yiiwebApplication::run() 方法时,它进行的第一个操作就是解析输入的请求,然后实例化对应的控制器操作处理这个请求。该过程就被称为引导路由(routing)。(译注:中文里既是动词也是名词)

解析路由

路由引导的第一步,是把传入请求解析为一个路由。如我们在 控制器(Controllers) 章节中所描述的那样,路由是一个用于定位控制器操作的地址。这个过程通过 request 应用组件的 yiiwebRequest::resolve() 方法实现,该方法会调用 URL 管理器 进行实质上的请求解析工作。

默认情况下,传入请求会包含一个名为 r 的 GET 参数,它的值即被视为路由。但是如果启用 yiiwebUrlManager::enablePrettyUrl,那么在确定请求的路由时,就会进行更多处理。具体的细节请参考 URL 的解析与生成 章节。

假使某路由最终实在无法被确定,那么 request 组件会抛出 yiiwebNotFoundHttpException 异常(译注:大名鼎鼎的 404)。

缺省路由

如果传入请求并没有提供一个具体的路由,(一般这种情况多为于对首页的请求)此时就会启用由 yiiwebApplication::defaultRoute 属性所指定的缺省路由。该属性的默认值为 site/index,它指向 site 控制器的 index 操作。你可以像这样在应用配置中调整该属性的值:

return [
    // ...
    'defaultRoute' => 'main/index',
];

catchAll 路由(全拦截路由)

有时候,你会想要将你的 Web 应用临时调整到维护模式,所有的请求下都会显示相同的信息页。当然,要实现这一点有很多种方法。这里面最简单快捷的方法就是在应用配置中设置下 yiiwebApplication::catchAll 属性:

return [
    // ...
    'catchAll' => ['site/offline'],
];

catchAll 属性需要传入一个数组做参数,该数组的第一个元素为路由,剩下的元素会(以名值对的形式)指定绑定于该操作的各个参数。

当设置了 catchAll 属性时,它会替换掉所有从输入的请求中解析出来的路由。如果是上文的这种设置,用于处理所有传入请求的操作都会是相同的 site/offline

创建操作

一旦请求路由被确定了,紧接着的步骤就是创建一个“操作(action)”对象,用以响应该路由。

路由可以用里面的斜杠分割成多个组成片段,举个栗子,site/index 可以分解为 site 和 index 两部分。每个片段都是指向某一模块(Module)、控制器(Controller)或操作(action)的 ID。

从路由的首个片段开始,应用会经过以下流程依次创建模块(如果有),控制器,以及操作:

  1. 设置应用主体为当前模块。
  2. 检查当前模块的 yiibaseModule::controllerMap 是否包含当前 ID。如果是,会根据该表中的配置创建一个控制器对象,然后跳到步骤五执行该路由的后续片段。
  3. 检查该 ID 是否指向当前模块中 yiibaseModule::modules 属性里的模块列表中的一个模块。如果是,会根据该模块表中的配置创建一个模块对象,然后会以新创建的模块为环境,跳回步骤二解析下一段路由。
  4. 将该 ID 视为控制器 ID,并创建控制器对象。用下个步骤解析路由里剩下的片段。
  5. 控制器会在他的 yiibaseController::actions()里搜索当前 ID。如果找得到,它会根据该映射表中的配置创建一个操作对象;反之,控制器则会尝试创建一个与该 ID 相对应,由某个 action 方法所定义的行内操作(inline action)。

在上面的步骤里,如果有任何错误发生,都会抛出 yiiwebNotFoundHttpException,指出路由引导的过程失败了。


分类导航

关注微信下载离线手册

bootwiki移动版 bootwiki
(群号:472910771)