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

操作客户端脚本(Working with Client Scripts)


注意: 此部分应用于开发环境

注册脚本

你可以使用 yiiwebView 对象注册脚本。这里有两个专门的方法: (1)yiiwebView::registerJs() 用于内联脚本。 (2)yiiwebView::registerJsFile() 用于注册引入外部脚本文件。 内联脚本通常用于配置和动态生成代码。 这个方法的使用可以像下面这样:

$this->registerJs("var options = ".json_encode($options).";", View::POS_END, 'my-options');

第一个参数是我们想插入的实际JS代码。 第二个参数确定了JS代码插入页面的位置。可用的值如下:

  • yiiwebView::POS_HEAD 用在HEAD部分。
  • yiiwebView::POS_BEGIN 用在  标签的右边。
  • yiiwebView::POS_END 用在  标签的左边。
  • yiiwebView::POS_READY 为了在 ready 事件中执行代码,这里将自动注册yiiwebJqueryAsset。
  • yiiwebView::POS_LOAD 为了在 load 事件中执行代码,这里将自动注册yiiwebJqueryAsset。

最后一个参数是一个唯一的脚本ID,主要是用于标识一段代码块,在添加一段新的代码块时,如果当前页面已经存在同样ID代码块时,那么将会被新的替换。 如果你不传这个参数,JS代码本身将会作为ID来使用。

外部脚本的引入使用像下面这样:

$this->registerJsFile('http://example.com/js/main.js', ['depends' => [yiiwebJqueryAsset::className()]]);

yiiwebView::registerJsFile() 中参数的使用与 yiiwebView::registerCssFile() 中的参数使用类似。 在上面的例子中,我们注册了main.js 文件,并且依赖于 JqueryAsset 类。这意味着 main.js 文件将被添加在 jquery.js 的后面。 如果没有这个依赖规范的话,main.js和 jquery.js 两者之间的顺序将不会被定义。

和 yiiwebView::registerCssFile() 一样,我们强烈建议您使用 asset bundles 来注册外部JS文件,而非使用 yiiwebView::registerJsFile() 来注册。

注册资源包

正如前面所提到的,我们推荐优先使用资源包而非直接使用CSS和JavaScript。 你可以在资源管理器 asset manager 部分查看更多细节。 至于怎样使用已经定义的资源包,这很简单:

frontendassetsAppAsset::register($this);

注册 CSS

你可以使用 yiiwebView::registerCss() 或者 yiiwebView::registerCssFile() 来注册CSS。 前者是注册一段CSS代码块,而后者则是注册引入外部的CSS文件,例如:

$this->registerCss("body { background: #f00; }");

上面的代码执行结果相当于在页面头部中添加了下面的代码:

$this->registerCss("body { background: #f00; }");

如果你想指定样式标记的附加属性,通过一个名值对的数组添加到第三个参数。 如果你需要确保只有一个单样式标签,则需要使用第四个参数作为meta标签的描述。

$this->registerCssFile("http://example.com/css/themes/black-and-white.css", [
    'depends' => [BootstrapAsset::className()],
    'media' => 'print',
], 'css-print-theme');

上面的代码将在页面的头部添加一个link引入CSS文件。

  • 第一个参数指明被注册的CSS文件。
  • 第二个参数指明  标签的HTML属性,选项 depends 是专门处理指明CSS文件依赖于哪个资源包。在这种情况下,依赖资源包就是 yiibootstrapBootstrapAsset。这意味着CSS文件将被添加在 yiibootstrapBootstrapAsset 之后。
  • 最后一个参数指明一个ID来标识这个CSS文件。假如这个参数未传,CSS文件的URL将被作为ID来替代。

我们强烈建议使用 asset bundles 来注册外部CSS文件, 而非使用 yiiwebView::registerCssFile() 来注册。 使用资源包允许你合并并且压缩多个CSS文件,对于高流量的网站来说,这是比较理想的方式。


分类导航

关注微信下载离线手册

bootwiki移动版 bootwiki
(群号:472910771)