入口腳本

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

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

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

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

• 定義全局常量；
• 注冊?Composer 自動加載器；
• 包含 Yii 類文件；
• 加載應用配置；
• 創(chuàng)建一個應用實例并配置;
• 調(diào)用 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');

// 創(chuàng)建、配置、運行一個應用
(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);

// 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：標識應用是否運行在調(diào)試模式。當在調(diào)試模式下，應用會保留更多日志信息，如果拋出異常，會顯示詳細的錯誤調(diào)用堆棧。因此，調(diào)試模式主要適合在開發(fā)階段使用，YII_DEBUG?默認值為 false。
• YII_ENV：標識應用運行的環(huán)境，詳情請查閱配置章節(jié)。YII_ENV?默認值為?'prod'，表示應用運行在線上產(chǎn)品環(huán)境。
• YII_ENABLE_ERROR_HANDLER：標識是否啟用 Yii 提供的錯誤處理，默認為 true。

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

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

上面的代碼等同于:

if (!defined('YII_DEBUG')) {
    define('YII_DEBUG', true);
}

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

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