You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
110 lines
3.5 KiB
110 lines
3.5 KiB
10 years ago
|
入口脚本
|
||
|
=============
|
||
|
|
||
|
入口脚本是应用启动流程中的第一环,一个应用(不管是网页应用还是控制台应用)只有一个入口脚本,
|
||
|
终端用户的请求通过入口脚本实例化应用并将将请求转发到应用。
|
||
|
|
||
|
网页应用的入口脚本必须放在终端用户能够访问的目录下,通常命名为`index.php`,只要网页服务器能找到也可以命名为其他名称。
|
||
|
|
||
|
控制台应用的入口脚本一般在应用根目录下名称为`yii`(后缀为.php),该文件需要有执行权限,
|
||
|
用户通过命令./yii <route> [arguments] [options]来执行控制台应用。
|
||
|
|
||
|
入口脚本主要完成一下工作:
|
||
|
|
||
|
* 定义全局常量;
|
||
|
* 注册[Composer 自动加载器](http://getcomposer.org/doc/01-basic-usage.md#autoloading)
|
||
|
* 包含[[Yii]]类文件;
|
||
|
* 加载应用配置;
|
||
|
* 创建一个[应用](structure-applications.md)实例并配置;
|
||
|
* 调用 [[yii\base\Application::run()]] 来处理请求.
|
||
|
|
||
|
|
||
|
## 网页应用 <a name="web-applications"></a>
|
||
|
|
||
|
以下是[Basic Web Application Template](start-installation.md)入口脚本的代码:
|
||
|
|
||
|
```php
|
||
|
<?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();
|
||
|
```
|
||
|
|
||
|
|
||
|
## 控制台应用 <a name="console-applications"></a>
|
||
|
|
||
|
以下是一个控制台应用的入口脚本:
|
||
|
|
||
|
```php
|
||
|
#!/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);
|
||
|
```
|
||
|
|
||
|
|
||
|
## 定义常量 <a name="defining-constants"></a>
|
||
|
|
||
|
入口脚本是最好的定义全局常量的地方,Yii支持一下3个常量:
|
||
|
Entry scripts are the best place for defining global constants. Yii supports the following three constants:
|
||
|
|
||
|
* `YII_DEBUG`: 标识应用是否运行在调试模式,当在调试模式下,会保留更多日志信息,如果错误抛出,会显示详细的错误调用堆栈。
|
||
|
因此,调试模式适合在开发阶段使用,`YII_DEBUG`默认值为false。
|
||
|
* `YII_ENV`: 标识应用运行的环境,详情请查阅[配置](concept-configurations.md#environment-constants)一节。
|
||
|
`YII_ENV` 默认值为 `'prod'`,表示应用运行在线上产品环境。
|
||
|
* `YII_ENABLE_ERROR_HANDLER`: 标识是否启用Yii提供的错误处理,默认为true。
|
||
|
|
||
|
当定义一个常量时,通常使用类似如下代码来定义:
|
||
|
|
||
|
```php
|
||
|
defined('YII_DEBUG') or define('YII_DEBUG', true);
|
||
|
```
|
||
|
|
||
|
上面的代码等同于如下代码:
|
||
|
|
||
|
```php
|
||
|
if (!defined('YII_DEBUG')) {
|
||
|
define('YII_DEBUG', true);
|
||
|
}
|
||
|
```
|
||
|
|
||
|
第一段代码明显的简洁易懂。
|
||
|
|
||
|
常量定义应该在入口脚本的开头,这样包含其他PHP文件时,常量就能生效。
|