Yii 框架入口脚本示例分析

本文实例讲述了yii 框架入口脚本。分享给大家供大家参考，具体如下：

入口脚本

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

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);
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/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 文件时， 常量就能生效。