• Yii关键概念


    basic/                  应用根目录
        composer.json       Composer 配置文件, 描述包信息
        config/             包含应用配置及其它配置
            console.php     控制台应用配置信息
            web.php         Web 应用配置信息
        commands/           包含控制台命令类
        controllers/        包含控制器类
        models/             包含模型类
        runtime/            包含 Yii 在运行时生成的文件,例如日志和缓存文件
        vendor/             包含已经安装的 Composer 包,包括 Yii 框架自身
        views/              包含视图文件
        web/                Web 应用根目录,包含 Web 入口文件
            assets/         包含 Yii 发布的资源文件(javascript 和 css)
            index.php       应用入口文件
        yii                 Yii 控制台命令执行脚本

    入口脚本

    入口脚本是应用启动流程中的第一环, 一个应用(不管是网页应用还是控制台应用)只有一个入口脚本。

    终端用户的请求通过入口脚本实例化应用并将将请求转发到应用。

    Web 应用的入口脚本必须放在终端用户能够访问的目录下, 通常命名为 index.php

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

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

    • 定义全局常量;
    • 注册 Composer 自动加载器
    • 包含 Yii 类文件;
    • 加载应用配置;
    • 创建一个应用实例并配置;
    • 调用 yiiaseApplication::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');
    
    // 创建、配置、运行一个应用
    (new yiiwebApplication($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);
    
    // 注册 Composer 自动加载器
    require(__DIR__ . '/vendor/autoload.php');
    
    // 包含 Yii 类文件
    require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php');
    
    // 加载应用配置
    $config = require(__DIR__ . '/config/console.php');
    
    $application = new yiiconsoleApplication($config);
    $exitCode = $application->run();
    exit($exitCode);
     
    

      

    定义常量 

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

    • YII_DEBUG:标识应用是否运行在调试模式。当在调试模式下, 应用会保留更多日志信息,如果抛出异常,会显示详细的错误调用堆栈。 因此,调试模式主要适合在开发阶段使用,YII_DEBUG 默认值为 false。
    • YII_ENV:标识应用运行的环境, 详情请查阅配置章节。 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 文件时, 常量就能生效。

    类自动加载(Autoloading)

    Yii 依靠类自动加载机制来定位和包含所需的类文件。

    它提供一个高性能且完美支持PSR-4 标准 (中文汉化)的自动加载器。

    该自动加载器会在引入框架文件 Yii.php 时安装好。

    注意:为了简化叙述,本篇文档中我们只会提及类的自动加载。 不过,要记得文中的描述同样也适用于接口和Trait(特质)的自动加载哦。

    使用 Yii 自动加载器 要使用 Yii 的类自动加载器

    你需要在创建和命名类的时候遵循两个简单的规则:

    1. 每个类都必须置于命名空间之下 (比如 fooarMyClass)。
    2. 每个类都必须保存为单独文件,且其完整路径能用以下算法取得:

    // $className 是一个开头包含反斜杠的完整类名(译注:请自行谷歌:fully qualified class name)

    $classFile = Yii::getAlias('@' . str_replace('\', '/', $className) . '.php');把\更新成/

    举例来说,若某个类名为 fooarMyClass,对应类的文件路径别名会是 @foo/bar/MyClass.php

    为了让该别名能被正确解析为文件路径,@foo 或 @foo/bar 中的一个必须是根别名

    当我们使用基本应用模版时,可以把你的类放置在顶级命名空间 app 下, 这样它们就可以被 Yii 自动加载,而无需定义一个新的别名。

    这是因为 @app 本身是一个预定义别名且类似于 appcomponentsMyClass 这样的类名, 基于我们刚才所提到的算法,可以正确解析出 AppBasePath/components/MyClass.php 路径。

    类映射表(Class Map) 

    Yii 类自动加载器支持类映射表功能,该功能会建立一个从类的名字到类文件路径的映射。

    当自动加载器加载一个文件时,他首先检查映射表里有没有该类。

    如果有,对应的文件路径就直接加载了,省掉了进一步的检查。

    这让类的自动加载变得超级快。事实上所有的 Yii 核心类都是这样加载的。

    你可以用 Yii::$classMap 方法向映射表中添加类,

    Yii::$classMap['fooarMyClass'] = 'path/to/MyClass.php';

    别名可以被用于指定类文件的路径。

    你应该在引导启动的过程中设置类映射表,这样映射表就可以在你使用具体类之前就准备好。

    用其他自动加载器 

    因为 Yii 完全支持 Composer 管理依赖包, 所以推荐你也同时安装 Composer 的自动加载器,如果你用了一些自带自动加载器的第三方类库, 你应该也安装下它们。

    当你同时使用其他自动加载器和 Yii 自动加载器时,应该在其他自动加载器安装成功之后,再包含 Yii.php 文件。

    这将使 Yii 成为第一个响应任何类自动加载请求的自动加载器。

    举例来说,以下代码提取自基本应用模版入口脚本 。

    第一行安装了 Composer 的自动加载器, 第二行才是 Yii 的自动加载器:

    //注册
    require(__DIR__ . '/../vendor/autoload.php');
    //包含
    require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

    你也可以只使用 Composer 的自动加载,而不用 Yii 的自动加载。 不过这样做的话,类的加载效率会下降,且你必须遵循 Composer 所设定的规则, 从而让你的类满足可以被自动加载的要求。

    补充:若你不想要使用 Yii 的自动加载器,你必须创建一个你自己版本的 Yii.php 文件, 并把它包含进你的入口脚本里。

    自动加载扩展类 

    Yii 自动加载器支持自动加载扩展的类。唯一的要求是它需要在 composer.json 文件里正确地定义 autoload 部分。请参考 Composer 文档(英文) (中文汉化),来了解如何正确描述 autoload 的更多细节。

    在你不使用 Yii 的自动加载器时,Composer 的自动加载器仍然可以帮你自动加载扩展内的类。

  • 相关阅读:
    AutoCAD利用VBA设置线型和添加用户自定义线性
    AutoVBA利用for循环创建同心圆弧
    AutoVBA利用Hacth对象填充图元对象
    AutoVBA利用AddArc方法创建Arc对象
    2011年6月5日星期天
    AutoVBA控件的tabindex和tabstop属性及with语句
    AutoVBA在绘图空间创建直线对象
    AutoVBA利用toolbar创建自己的工具栏
    AutoVBA调用AddCricle方法绘制圆
    AutoCAD利用VBA宏绘制多重平行线
  • 原文地址:https://www.cnblogs.com/ldphoebe/p/6073932.html
Copyright © 2020-2023  润新知