yii2 入口脚本
更新:HHH   时间:2023-1-7


yii2 入口脚本介绍

一、前言

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

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

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

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

1.定义全局常量;

2.注册 Composer 自动加载器;

3.包含 Yii 类文件;

4.加载应用配置;

5.创建一个应用实例并配置;

6.调用 yii\base\Application::run() 来处理请求。

二、Web 应用

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

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

/**

  • Yii console bootstrap file.

  • @link http://www.yiiframework.com/
  • @link http://www.codexueyuan.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 文件时,常量就能生效。

返回web开发教程...