入口脚本和请求生命周期

每个应用的入口文件 index.php 都位于应用的 web 目录下，首先来看看前台 frontend 的入口 index.php 文件的内容:

<?php
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');
require __DIR__ . '/../../vendor/autoload.php';
require __DIR__ . '/../../vendor/yiisoft/yii2/Yii.php';
require __DIR__ . '/../../common/config/bootstrap.php';
require __DIR__ . '/../config/bootstrap.php';
$config = yii\helpers\ArrayHelper::merge(
 require __DIR__ . '/../../common/config/main.php',
 require __DIR__ . '/../../common/config/main-local.php',
 require __DIR__ . '/../config/main.php',
 require __DIR__ . '/../config/main-local.php'
);
(new yii\web\Application($config))->run();

前两个 define 语句，定义了当前应用的运行模式和环境。

定义当前应用调试模式状态：true 开户调试模式，false 关闭调试模式；

defined('YII_DEBUG') or define('YII_DEBUG', true);//如果 YII_DEBUG 未定义，那么定义它为 true

定义当前应用的运行环境：dev 开发环境，prod 生产环境，test 测试环境；

defined('YII_ENV') or define('YII_ENV', 'dev');//如果 YII_ENV 未定义，那么定义它为 dev

环境与模式的作用不同。环境在代码中主要是影响配置文件。 YII_ENV 的 devprod test 三种环境， 会分别使 YII_ENV_DEV YII_ENV_PROD YII_ENV_TEST 的值为 true 。 在应用的配置文件中，特别是在相同的一个配置文件中，可以对不同环境做出不同的配置。

比如，你希望在开发环境下，前台应用启用调试工作条等，那么，可以这么做（frontend/config/main-local.php）:

<?php
$config = [
 ...
];
if (!YII_ENV_TEST) {
 // 以下配置在非 test 环境下生效，即 YII_ENV !== 'test' 时
 $config['bootstrap'][] = 'debug';
 $config['modules']['debug'] = [
 'class' => 'yii\debug\Module',
 ];
 $config['bootstrap'][] = 'gii';
 $config['modules']['gii'] = [
 'class' => 'yii\gii\Module',
 ];
}
return $config;

引入Yii框架

require __DIR__ . '/../../vendor/autoload.php';
require __DIR__ . '/../../vendor/yiisoft/yii2/Yii.php';
require __DIR__ . '/../../common/config/bootstrap.php';
require __DIR__ . '/../config/bootstrap.php';

• __DIR__ 表示当前 index.php 所在的目录
• /../../vendor/ 即根目录下的 vendor 目录
• /../../common/ 即根目录下的 common 目录
• /../config/ 即当前应用 frontend 目录下的 config 目录

第一个 require 引入了 verndor 目录下的 autoload.php，这个是composer的类自动加载机制注册文件。引入这个文件后，可以使用composer的类自动加载功能。

第二个 require 引入了 vendor 目录下面的 yiisoft/yii2/Yii.php，这是 Yii框架核心文件。 引入了这个类文件后，才能使用 Yii 的提供的各种功能，比如 Yii::setAlias()，Yii::$app 之类。

第三个 require 引入了 common 目录下面的 config/bootstrap.php， 这个文件主要用于执行一些 Yii 应用引导的代码，比如定义一系列的路径别名:

<?php
Yii::setAlias('@common', dirname(__DIR__));
Yii::setAlias('@frontend', dirname(dirname(__DIR__)) . '/frontend');
Yii::setAlias('@backend', dirname(dirname(__DIR__)) . '/backend');
Yii::setAlias('@console', dirname(dirname(__DIR__)) . '/console');

这是默认安装后定义好的 common frontend backend console vendor 5个路径别名，如果你要新增一个 api 应用目录, 可以在这个文件里面加一行:

Yii::setAlias('@api', dirname(dirname(__DIR__)) . '/api');

第四个 require 引入了 frontend 目录下面的 config/bootstrap.php。 作用与上面第三个类似，只是其中的代码仅适用于当前应用（frontend）。 而第三个require中的，是适应于全部应用（公共的）。

接着调用了Yii的助手类 yii\helpers\ArrayHelper 的函数 merge，它的作用在于合并参数所指定的各个数组，后面的数组会把前面数组中相同下标的元素覆盖掉。

$config = yii\helpers\ArrayHelper::merge(
 require __DIR__ . '/../../common/config/main.php',
 require __DIR__ . '/../../common/config/main-local.php',
 require __DIR__ . '/../config/main.php',
 require __DIR__ . '/../config/main-local.php'
);

公共应用 common 下的2个配置文件，和当前应用 frontend 下的2个配置文件，在优先顺序上，当前应用的配置覆盖公共应用的配置。同时，带有 -local 的配置文件在后，所以，本地配置文件覆盖团队配置文件。最后把合并好的配置数组 $config 作为Yii框架web应用的初始化参数，创建了一个web应用实例，这时，Yii就跑起来了：

(new yii\web\Application($config))->run();

Yii框架给我们提供了两种应用：web应用 yii\web\Application 和 控制台应用 yii\console\Application；web应用处理网页请求，控制台应用处理 shell cmd命令式交互的请求。 控制台应用入口是根目录下的 yii 文件：

#!/usr/bin/env php
<?php
/**
 * Yii console bootstrap file.
 */
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');
require __DIR__ . '/vendor/autoload.php';
require __DIR__ . '/vendor/yiisoft/yii2/Yii.php';
require __DIR__ . '/common/config/bootstrap.php';
require __DIR__ . '/console/config/bootstrap.php';
$config = yii\helpers\ArrayHelper::merge(
 require __DIR__ . '/common/config/main.php',
 require __DIR__ . '/common/config/main-local.php',
 require __DIR__ . '/console/config/main.php',
 require __DIR__ . '/console/config/main-local.php'
);
$application = new yii\console\Application($config);
$exitCode = $application->run();
exit($exitCode);

对于Windows系统而言，yii 文件无法直接运行。所以，细心的Yii为我们准备了一个 yii.bat 文件，这个文件会以 php yii 形式调用PHP来运行入口脚本。

生命周期

每一次 Yii 应用开始处理 HTTP 请求时，它都会进行一个近似的流程。

• 用户提交指向入口脚本 web/index.php 的请求。
• 入口脚本会加载 配置数组 并创建一个 应用 实例用于处理该请求。
• 应用会通过 request（请求） 应用组件 解析被请求的 路由。
• 应用创建一个 controller（控制器） 实例具体处理请求。
• 控制器会创建一个 action（动作） 实例并为该动作执行相关的 Filters（访问过滤器）。
• 如果任何一个过滤器验证失败，该动作会被取消。
• 如果全部的过滤器都通过，该动作就会被执行。
• 动作会加载一个 数据模型，一般是从数据库中加载。
• 动作会渲染一个 View（视图），并为其提供所需的数据模型。
• 渲染得到的结果会返回给 response（响应） 应用组件。
• 响应组件会把渲染结果发回给用户的浏览器。