入口腳本（Entry Scripts）

入口腳本

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

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

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

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

• 定義全局常量；
• 注冊(cè)?Composer 自動(dòng)加載器；
• 包含 Yii 類(lèi)文件；
• 加載應(yīng)用配置；
• 創(chuàng)建一個(gè)應(yīng)用實(shí)例并配置;
• 調(diào)用 yii\base\Application::run() 來(lái)處理請(qǐng)求。

Web 應(yīng)用

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

<?php

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

// 注冊(cè) Composer 自動(dòng)加載器
require(__DIR__ . '/../vendor/autoload.php');

// 包含 Yii 類(lèi)文件
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

// 加載應(yīng)用配置
$config = require(__DIR__ . '/../config/web.php');

// 創(chuàng)建、配置、運(yùn)行一個(gè)應(yīng)用
(new yii\web\Application($config))->run();

控制臺(tái)應(yīng)用

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

#!/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 默認(rèn)沒(méi)有定義 STDIN 和 STDOUT
defined('STDIN') or define('STDIN', fopen('php://stdin', 'r'));
defined('STDOUT') or define('STDOUT', fopen('php://stdout', 'w'));

// 注冊(cè) Composer 自動(dòng)加載器
require(__DIR__ . '/vendor/autoload.php');

// 包含 Yii 類(lèi)文件
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 支持以下三個(gè)常量：

• YII_DEBUG：標(biāo)識(shí)應(yīng)用是否運(yùn)行在調(diào)試模式。當(dāng)在調(diào)試模式下，應(yīng)用會(huì)保留更多日志信息，如果拋出異常，會(huì)顯示詳細(xì)的錯(cuò)誤調(diào)用堆棧。因此，調(diào)試模式主要適合在開(kāi)發(fā)階段使用，YII_DEBUG?默認(rèn)值為 false。
• YII_ENV：標(biāo)識(shí)應(yīng)用運(yùn)行的環(huán)境，詳情請(qǐng)查閱配置章節(jié)。YII_ENV?默認(rèn)值為?'prod'，表示應(yīng)用運(yùn)行在線上產(chǎn)品環(huán)境。
• YII_ENABLE_ERROR_HANDLER：標(biāo)識(shí)是否啟用 Yii 提供的錯(cuò)誤處理，默認(rèn)為 true。

當(dāng)定義一個(gè)常量時(shí)，通常使用類(lèi)似如下代碼來(lái)定義：

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

上面的代碼等同于:

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

顯然第一段代碼更加簡(jiǎn)潔易懂。

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