Yii2中文手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
目录 搜索
阅读前篇 简介 Yii 是什么 从 Yii 1.1 升级 入门 安装 Yii 运行应用 第一次问候 使用Forms 数据库应用 使用 Gii 生成代码 进阶 应用结构 概述 入口脚本 应用（Applications） 应用组件（Application Components） 控制器（Controllers） 模型（Models） 视图（views） 模块（Modules） 过滤器（Filters） 小部件（Widgets） 前端资源（Assets） 扩展（Extensions） 请求处理 运行概述 启动引导（Bootstrapping） 路由和创建URL 请求（Requests） 响应（Responses） Sessions 和 Cookies 错误处理（Handling Errors） 日志（Logging） 关键概念 组件（Component） 属性（Property） 事件（Events） 行为（Behaviors） 配置（Configurations） 别名（Aliases） 类自动加载（Autoloading） 服务定位器（Service Locator） 依赖注入容器（Dependency Injection Container） 配合数据库工作 数据库访问 (Data Access Objects) 查询生成器（Query Builder） 活动记录（Active Record） 数据库迁移（Migrations） Sphinx Redis MongoDB Elasticsearch 接收用户数据 创建表单(Creating Forms) 输入验证(Validating Input) 文件上传(Uploading Files) 收集列表输入(Collecting Tabular Input) 多模型的复合表单(Getting Data for Multiple Models) 显示数据 格式化输出数据（Data Formatting） 分页（Pagination） 排序（Sorting） 数据提供器（Data Providers） 数据小部件（Data Widgets） 客户端脚本使用(Working with Client Scripts) 主题（Theming） 安全 认证（Authentication） 授权（Authorization） 处理密码（Working with Passwords） 客户端认证（Auth Clients） 最佳安全实践（Best Practices） 缓存 概述 数据缓存 片段缓存 页面缓存 HTTP 缓存 RESTfull Web服务 快速入门（Quick Start） 资源（Resources） 控制器（Controllers） 路由（Routing） 格式化响应（Response Formatting） 授权认证（Authentication） 速率限制（Rate Limiting） 版本（Versioning） 错误处理（Error Handling） 开发工具 调试工具栏和调试器 使用Gii生成代码 生成API文档 测试 概述（Overview） 配置测试环境（Testing environment setup） 单元测试（Unit Tests） 功能测试（Function Tests） 验收测试（Acceptance Tests） 测试夹具（Fixtures） 高级专题 高级应用模板 创建自定义应用程序结构 控制台命令 核心验证器（Core Validators） 国际化 收发邮件 性能优化 共享主机环境 模板引擎 集成第三方代码 小部件 Bootstrap 小部件 Jquery UI 助手类 概述 Array 助手(ArrayHelper) Html 助手(Html) Url 助手(Url)

©
本文档使用 PHP中文网手册 发布

文字

入口脚本

入口脚本

入口脚本是应用启动流程中的第一环，一个应用（不管是网页应用还是控制台应用）只有一个入口脚本。终端用户的请求通过入口脚本实例化应用并将将请求转发到应用。

Web 应用的入口脚本必须放在终端用户能够访问的目录下，通常命名为 index.php，也可以使用 Web 服务器能定位到的其他名称。

控制台应用的入口脚本一般在应用根目录下命名为 yii（后缀为.php），该文件需要有执行权限，这样用户就能通过命令 ./yii <route> [arguments] [options] 来运行控制台应用。

入口脚本主要完成以下工作：

  • 定义全局常量；
  • 注册 Composer 自动加载器；
  • 包含 Yii 类文件；
  • 加载应用配置；
  • 创建一个应用实例并配置;
  • 调用 yii\base\Application::run() 来处理请求。

Web 应用

以下是基础应用模版入口脚本的代码：

<?php

defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');

// 注册 Composer 自动加载器require(__DIR__ . '/../vendor/autoload.php');

// 包含 Yii 类文件require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

// 加载应用配置$config = require(__DIR__ . '/../config/web.php');

// 创建、配置、运行一个应用
(new yii\web\Application($config))->run();

控制台应用

以下是一个控制台应用的入口脚本：

#!/usr/bin/env php<?php/**
 * Yii console bootstrap file.
 *
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

defined('YII_DEBUG') or define('YII_DEBUG', true);

// fcgi 默认没有定义 STDIN 和 STDOUT
defined('STDIN') or define('STDIN', fopen('php://stdin', 'r'));
defined('STDOUT') or define('STDOUT', fopen('php://stdout', 'w'));

// 注册 Composer 自动加载器require(__DIR__ . '/vendor/autoload.php');

// 包含 Yii 类文件require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php');

// 加载应用配置$config = require(__DIR__ . '/config/console.php');

$application = new yii\console\Application($config);
$exitCode = $application->run();
exit($exitCode);

定义常量

入口脚本是定义全局常量的最好地方，Yii 支持以下三个常量：

  • YII_DEBUG：标识应用是否运行在调试模式。当在调试模式下，应用会保留更多日志信息，如果抛出异常，会显示详细的错误调用堆栈。因此，调试模式主要适合在开发阶段使用，YII_DEBUG 默认值为 false。
  • YII_ENV：标识应用运行的环境，详情请查阅配置章节。YII_ENV 默认值为 'prod'，表示应用运行在线上产品环境。
  • YII_ENABLE_ERROR_HANDLER：标识是否启用 Yii 提供的错误处理，默认为 true。

当定义一个常量时，通常使用类似如下代码来定义：

defined('YII_DEBUG') or define('YII_DEBUG', true);

上面的代码等同于:

if (!defined('YII_DEBUG')) {
    define('YII_DEBUG', true);
}

显然第一段代码更加简洁易懂。

常量定义应该在入口脚本的开头，这样包含其他 PHP 文件时，常量就能生效。
上一篇： 下一篇：