yii2 入口腳本

yii2 入口腳本介紹

一、前言

入口腳本是應(yīng)用啟動流程中的第一環(huán)，一個應(yīng)用(不管是網(wǎng)頁應(yīng)用還是控制臺應(yīng)用)只有一個入口腳本。終端用戶的請求通過入口腳本實例化應(yīng)用并將將請求轉(zhuǎn)發(fā)到應(yīng)用。

Web 應(yīng)用的入口腳本必須放在終端用戶能夠訪問的目錄下，通常命名為 index.php，也可以使用 Web 服務(wù)器能定位到的其他名稱。

控制臺應(yīng)用的入口腳本一般在應(yīng)用根目錄下命名為 yii(后綴為.php)，該文件需要有執(zhí)行權(quán)限，這樣用戶就能通過命令 ./yii[arguments] [options] 來運行控制臺應(yīng)用。

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

1.定義全局常量;

2.注冊 Composer 自動加載器;

3.包含 Yii 類文件;

4.加載應(yīng)用配置;

5.創(chuàng)建一個應(yīng)用實例并配置;

6.調(diào)用 yii\base\Application::run() 來處理請求。

二、Web 應(yīng)用

以下是基礎(chǔ)應(yīng)用模版入口腳本的代碼：

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');

// 加載應(yīng)用配置

$config = require(DIR . '/../config/web.php');

// 創(chuàng)建、配置、運行一個應(yīng)用

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

三、控制臺應(yīng)用

以下是一個控制臺應(yīng)用的入口腳本：

#!/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');

// 加載應(yīng)用配置

$config = require(DIR . '/config/console.php');

$application = new yii\console\Application($config);

$exitCode = $application->run();

exit($exitCode);

四、定義常量

入口腳本是定義全局常量的最好地方，Yii 支持以下三個常量：

YII_DEBUG：標(biāo)識應(yīng)用是否運行在調(diào)試模式。當(dāng)在調(diào)試模式下，應(yīng)用會保留更多日志信息，如果拋出異常，會顯示詳細的錯誤調(diào)用堆棧。因此，調(diào)試模式主要適合在開發(fā)階段使用，YII_DEBUG 默認值為 false。

YII_ENV：標(biāo)識應(yīng)用運行的環(huán)境，詳情請查閱配置章節(jié)。YII_ENV 默認值為 'prod'，表示應(yīng)用運行在線上產(chǎn)品環(huán)境。

YII_ENABLE_ERROR_HANDLER：標(biāo)識是否啟用 Yii 提供的錯誤處理，默認為 true。

當(dāng)定義一個常量時，通常使用類似如下代碼來定義：

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

上面的代碼等同于:

if (!defined('YII_DEBUG')) {

define('YII_DEBUG', true);

}

顯然第一段代碼更加簡潔易懂。

常量定義應(yīng)該在入口腳本的開頭，這樣包含其他 PHP 文件時，常量就能生效。