×
关于 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)

应用组件(Application Components)


应用主体是服务定位器,它部署一组提供各种不同功能的 应用组件 来处理请求。 例如,urlManager组件负责处理网页请求路由到对应的控制器。db组件提供数据库相关服务等等。

在同一个应用中,每个应用组件都有一个独一无二的 ID 用来区分其他应用组件,你可以通过如下表达式访问应用组件。

Yii::$app->componentID

例如,可以使用 Yii::$app->db 来获取到已注册到应用的 yiidbConnection, 使用 Yii::$app->cache 来获取到已注册到应用的 yiicachingCache。

第一次使用以上表达式时候会创建应用组件实例,后续再访问会返回此实例,无需再次创建。

应用组件可以是任意对象,可以在 应用主体配置配置 yiibaseApplication::components 属性 . 例如:

[
    'components' => [
        // 使用类名注册 "cache" 组件
        'cache' => 'yiicachingApcCache',

        // 使用配置数组注册 "db" 组件
        'db' => [
            'class' => 'yiidbConnection',
            'dsn' => 'mysql:host=localhost;dbname=demo',
            'username' => 'root',
            'password' => '',
        ],

        // 使用函数注册"search" 组件
        'search' => function () {
            return new appcomponentsSolrService;
        },
    ],
]

补充:请谨慎注册太多应用组件,应用组件就像全局变量,使用太多可能加大测试和维护的难度。 一般情况下可以在需要时再创建本地组件。

引导启动组件

上面提到一个应用组件只会在第一次访问时实例化,如果处理请求过程没有访问的话就不实例化。 有时你想在每个请求处理过程都实例化某个组件即便它不会被访问, 可以将该组件ID加入到应用主体的 yiibaseApplication::bootstrap 属性中。

例如, 如下的应用主体配置保证了 log 组件一直被加载。

[
    'bootstrap' => [
        // 将 log 组件 ID 加入引导让它始终载入
        'log',
    ],
    'components' => [
        'log' => [
            // "log" 组件的配置
        ],
    ],
]

核心应用组件

Yii 定义了一组固定ID和默认配置的 核心 组件,例如 yiiwebApplication::request 组件 用来收集用户请求并解析 路由; yiibaseApplication::db 代表一个可以执行数据库操作的数据库连接。 通过这些组件,Yii应用主体能处理用户请求。

下面是预定义的核心应用组件列表,可以和普通应用组件一样配置和自定义它们。 当你配置一个核心组件,不指定它的类名的话就会使用Yii默认指定的类。

  • yiiwebAssetManager: 管理资源包和资源发布,详情请参考 管理资源 一节。
  • yiidbConnection: 代表一个可以执行数据库操作的数据库连接, 注意配置该组件时必须指定组件类名和其他相关组件属性,如yiidbConnection::dsn。 详情请参考 数据访问对象 一节。
  • yiibaseApplication::errorHandler: 处理 PHP 错误和异常, 详情请参考 错误处理 一节。
  • yiii18nFormatter: 格式化输出显示给终端用户的数据,例如数字可能要带分隔符, 日期使用长格式。详情请参考 格式化输出数据一节。
  • yiii18nI18N: 支持信息翻译和格式化。详情请参考 国际化 一节。
  • yiilogDispatcher: 管理日志对象。详情请参考 日志 一节。
  • yiiswiftmailerMailer: 支持生成邮件结构并发送,详情请参考 邮件 一节。
  • yiibaseApplication::response: 代表发送给用户的响应, 详情请参考 响应 一节。
  • yiibaseApplication::request: 代表从终端用户处接收到的请求, 详情请参考 请求 一节。
  • yiiwebSession: 代表会话信息,仅在yiiwebApplication 网页应用中可用, 详情请参考 Sessions (会话) and Cookies 一节。
  • yiiwebUrlManager: 支持URL地址解析和创建, 详情请参考 URL 解析和生成 一节。
  • yiiwebUser: 代表认证登录用户信息,仅在yiiwebApplication 网页应用中可用, 详情请参考 认证 一节。
  • yiiwebView: 支持渲染视图,详情请参考 Views 一节。

分类导航

关注微信下载离线手册

bootwiki移动版 bootwiki
(群号:472910771)