# 入口腳本
入口腳本是應用啟動流程中的第一環，一個應用（不管是網頁應用還是控制臺應用）只有一個入口腳本。終端用戶的請求通過入口腳本實例化應用并將將請求轉發到應用。
Web 應用的入口腳本必須放在終端用戶能夠訪問的目錄下，通常命名為?`index.php`，也可以使用 Web 服務器能定位到的其他名稱。
控制臺應用的入口腳本一般在應用根目錄下命名為?`yii`（后綴為.php），該文件需要有執行權限，這樣用戶就能通過命令?`./yii <route> [arguments] [options]`?來運行控制臺應用。
入口腳本主要完成以下工作：
* 定義全局常量；
* 注冊?[Composer 自動加載器](https://getcomposer.org/doc/01-basic-usage.md#autoloading)；
* 包含 Yii 類文件；
* 加載應用配置；
* 創建一個[應用](http://www.yiichina.com/doc/guide/2.0/structure-applications)實例并配置;
* 調用 yii\base\Application::run() 來處理請求。
## Web 應用
以下是[基礎應用模版](http://www.yiichina.com/doc/guide/2.0/start-installation)入口腳本的代碼：
~~~
<?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');
// 創建、配置、運行一個應用
(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`：標識應用是否運行在調試模式。當在調試模式下，應用會保留更多日志信息，如果拋出異常，會顯示詳細的錯誤調用堆棧。因此，調試模式主要適合在開發階段使用，`YII_DEBUG`?默認值為 false。
* `YII_ENV`：標識應用運行的環境，詳情請查閱[配置](http://www.yiichina.com/doc/guide/2.0/concept-configurations#environment-constants)章節。`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 文件時，常量就能生效。
- 介紹（Introduction）
- 關于 Yii（About Yii）
- 從 Yii 1.1 升級（Upgrading from Version 1.1）
- 入門（Getting Started）
- 安裝 Yii（Installing Yii）
- 運行應用（Running Applications）
- 第一次問候（Saying Hello）
- 使用 Forms（Working with Forms）
- 玩轉 Databases（Working with Databases）
- 用 Gii 生成代碼（Generating Code with Gii）
- 更上一層樓（Looking Ahead）
- 應用結構（Application Structure）
- 結構概述（Overview）
- 入口腳本（Entry Scripts）
- 應用（Applications）
- 應用組件（Application Components）
- 控制器（Controllers）
- 模型（Models）
- 視圖（Views）
- 模塊（Modules）
- 過濾器（Filters）
- 小部件（Widgets）
- 前端資源（Assets）
- 擴展（Extensions）
- 請求處理（Handling Requests）
- 運行概述（Overview）
- 引導（Bootstrapping）
- 路由引導與創建 URL（Routing and URL Creation）
- 請求（Requests）
- 響應（Responses）
- Sessions and Cookies
- 錯誤處理（Handling Errors）
- 日志（Logging）
- 關鍵概念（Key Concepts）
- 組件（Components）
- 屬性（Properties）
- 事件（Events）
- 行為（Behaviors）
- 配置（Configurations）
- 別名（Aliases）
- 類自動加載（Class Autoloading）
- 服務定位器（Service Locator）
- 依賴注入容器（Dependency Injection Container）
- 配合數據庫工作（Working with Databases）
- 數據庫訪問（Data Access Objects）: 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器（Query Builder）: 使用簡單抽象層查詢數據庫
- 活動記錄（Active Record）: 活動記錄對象關系映射（ORM），檢索和操作記錄、定義關聯關系
- 數據庫遷移（Migrations）: 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據（Getting Data from Users）
- 創建表單（Creating Forms）
- 輸入驗證（Validating Input）
- 文件上傳（Uploading Files）
- 收集列表輸入（Collecting Tabular Input）
- 多模型同時輸入（Getting Data for Multiple Models）
- 顯示數據（Displaying Data）
- 格式化輸出數據（Data Formatting）
- 分頁（Pagination）
- 排序（Sorting）
- 數據提供器（Data Providers）
- 數據小部件（Data Widgets）
- 操作客戶端腳本（Working with Client Scripts）
- 主題（Theming）
- 安全（Security）
- 認證（Authentication）
- 授權（Authorization）
- 處理密碼（Working with Passwords）
- 客戶端認證（Auth Clients）
- 安全領域的最佳實踐（Best Practices）
- 緩存（Caching）
- 概述（Overview）
- 數據緩存（Data Caching）
- 片段緩存（Fragment Caching）
- 分頁緩存（Page Caching）
- HTTP 緩存（HTTP Caching）
- RESTful Web 服務
- 快速入門（Quick Start）
- 資源（Resources）
- 控制器（Controllers）
- 路由（Routing）
- 格式化響應（Response Formatting）
- 授權驗證（Authentication）
- 速率限制（Rate Limiting）
- 版本化（Versioning）
- 錯誤處理（Error Handling）
- 開發工具（Development Tools）
- 調試工具欄和調試器（Debug Toolbar and Debugger）
- 使用 Gii 生成代碼（Generating Code using Gii）
- TBD 生成 API 文檔（Generating API Documentation）
- 測試（Testing）
- 概述（Overview）
- 搭建測試環境（Testing environment setup）
- 單元測試（Unit Tests）
- 功能測試（Functional Tests）
- 驗收測試（Acceptance Tests）
- 測試夾具（Fixtures）
- 高級專題（Special Topics）
- 高級應用模版（Advanced Project Template）
- 從頭構建自定義模版（Building Application from Scratch）
- 控制臺命令（Console Commands）
- 核心驗證器（Core Validators）
- 國際化（Internationalization）
- 收發郵件（Mailing）
- 性能優化（Performance Tuning）
- 共享主機環境（Shared Hosting Environment）
- 模板引擎（Template Engines）
- 集成第三方代碼（Working with Third-Party Code）
- 小部件（Widgets）
- Bootstrap 小部件（Bootstrap Widgets）
- jQuery UI 小部件（jQuery UI Widgets）
- 助手類（Helpers）
- 助手一覽（Overview）
- Array 助手（ArrayHelper）
- Html 助手（Html）
- Url 助手（Url）