yii2 入口腳本

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 文件時，常量就能生效。