手册教程~

YII 入口文件

入口脚本是应用启动流程中的第一环, 一个应用(不管是网页应用还是控制台应用)只有一个入口脚本。 终端用户的请求通过入口脚本实例化应用并将请求转发到应用。

Web 应用的入口脚本必须放在终端用户能够访问的目录下, 通常命名为 index.php, 也可以使用 Web 服务器能定位到的其他名称。

控制台应用的入口脚本一般在应用根目录下命名为 yii(后缀为.php), 该文件需要有执行权限, 这样用户就能通过命令 ./yii <route> [arguments] [options] 来运行控制台应用。

入口脚本主要完成以下工作:

  • 定义全局常量;

  • 注册 Composer 自动加载器

  • 包含 [[Yii]] 类文件;

  • 加载应用配置;

  • 创建一个应用实例并配置;

  • 调用 [[yii\base\Application::run()]] 来处理请求。


Web应用程序

下面的入口脚本中的代码 基本的Web项目模板 。

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

// register Composer autoloader
require(__DIR__ . '/../vendor/autoload.php');

// include Yii class file
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

// load application configuration
$config = require(__DIR__ . '/../config/web.php');

// create, configure and run application
(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);
 // register Composer autoloader
 require(__DIR__ . '/vendor/autoload.php');
 // include Yii class file
 require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php');
 // load application configuration
 $config = require(__DIR__ . '/config/console.php');
 $application = new yii\console\Application($config);
 $exitCode = $application->run();
 exit($exitCode);

定义常量

输入脚本可以定义全局常量是最好的地方。 Yii支持以下三个常量:

  • YII_DEBUG :指定是否在调试模式下运行应用程序。 在调试模式下,一个应用程序 将更多的日志信息,将显示详细错误调用堆栈异常被抛出。 对于这个 原因,应该使用调试模式主要是在开发过程中。 的默认值 YII_DEBUG 是假的。

  • YII_ENV :指定的环境中运行的应用程序。 这将是中描述 更多的细节 配置 部分。 的默认值 YII_ENV 是 “刺激” ,这意味着应用程序在生产环境中运行。

  • YII_ENABLE_ERROR_HANDLER :指定是否启用Yii提供的错误处理程序。 默认的 这个常数的值是正确的。

当定义一个常数,我们经常使用的代码如下:

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

相当于以下代码:

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

显然前者更简洁,更容易理解。

常量的定义应该做一个条目脚本的开头,这样他们就可以生效 当其他PHP文件被包括在内。