Yii2框架自动加载机制学习

Yii2 的自动加载分两部分,一部分是 Composer 的自动加载机制,另一部分是 Yii2 框架自身的自动加载机制。

Composer自动加载

对于库的自动加载信息,Composer 生成了一个 vendor/autoload.php 文件。你可以简单的引入这个文件,你会得到一个自动加载的支持。

在之前的文章,入口文件的介绍中,我们可以看到如下内容:

// 引入 vendor 中的 autoload.php 文件,会基于 composer 的机制自动加载类
require(__DIR__ . '/../vendor/autoload.php');

因为这个系列主要是关于 Yii2 的,所以有关 Composer 自动加载机制就不在这里详细说明了。

可查阅资料:

    Composer 自动加载
    Composer 自动加载-参考
    Composer 中文官网

Yii2 框架的自动加载机制

Yii2 框架的自动加载是通过 spl_autoload_register 方法实现的。

在之前的文章,入口文件的介绍中,我们可以看到如下内容:

// 引入 Yii 框架的文件 Yii.php
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

Yii.php 里究竟是什么内容?如何实现了自动加载?

下面我们来看一下,Yii.php 的内容如下:

<?php
/**
 * Yii bootstrap file.
 *
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */
require(__DIR__ . '/BaseYii.php');
/**
 * Yii is a helper class serving common framework functionalities.
 *
 * It extends from [[\yii\BaseYii]] which provides the actual implementation.
 * By writing your own Yii class, you can customize some functionalities of [[\yii\BaseYii]].
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
class Yii extends \yii\BaseYii
{
}
/**
 * spl_autoload_register — 注册给定的函数作为 __autoload 的实现
 *
 * bool spl_autoload_register ([ callable $autoload_function [, bool $throw = true [, bool $prepend = false ]]] )
 *
 * 将函数注册到SPL __autoload函数队列中。如果该队列中的函数尚未激活,则激活它们。
 * 如果在你的程序中已经实现了__autoload()函数,它必须显式注册到__autoload()队列中。
 * 因为 spl_autoload_register()函数会将Zend Engine中的__autoload()函数取代为spl_autoload()或spl_autoload_call()。
 * 如果需要多条 autoload 函数,spl_autoload_register() 满足了此类需求。
 * 它实际上创建了 autoload 函数的队列,按定义时的顺序逐个执行。
 * 相比之下, __autoload() 只可以定义一次。
 *
 * autoload_function
 * 欲注册的自动装载函数。如果没有提供任何参数,则自动注册 autoload 的默认实现函数spl_autoload()。
 *
 * throw
 * 此参数设置了 autoload_function 无法成功注册时, spl_autoload_register()是否抛出异常。
 *
 * prepend
 * 如果是 true,spl_autoload_register() 会添加函数到队列之首,而不是队列尾部。
 *
 * Yii 注册了 Yii 的 autoload 函数,实现自动加载, 其实现在 \yii\BaseYii 中
 */
spl_autoload_register(['Yii', 'autoload'], true, true);
// 定义 Yii 核心的 class 的类名与文件地址的 Map
Yii::$classMap = require(__DIR__ . '/classes.php');
// 创建 Yii 的依赖注入的容器
Yii::$container = new yii\di\Container();

其主要内容就是引入了 BaseYii.php 文件,然后声明了类 Yii,继承了 BaseYii,然后注册了 Yii (其实是 BaseYii)的 autoload 方法,去实现自动加载。之后又引入了Yii 核心类名与文件地址一一对应的 Map,存储到 Yii::$classMap 中。最后创建了一个 yii\di\Container 的实例,存储到 Yii::$container 中。

可以看出实现自动加载的关键代码是:

spl_autoload_register(['Yii', 'autoload'], true, true);

下面我们来看一下 BaseYii 中 autoload 方法的实现,其内容如下:

    /**
     * Class autoload loader.
     * This method is invoked automatically when PHP sees an unknown class.
     * The method will attempt to include the class file according to the following procedure:
     *
     * 1. Search in [[classMap]];
     * 2. If the class is namespaced (e.g. `yii\base\Component`), it will attempt
     *    to include the file associated with the corresponding path alias
     *    (e.g. `@yii/base/Component.php`);
     *
     * This autoloader allows loading classes that follow the [PSR-4 standard](http://www.php-fig.org/psr/psr-4/)
     * and have its top-level namespace or sub-namespaces defined as path aliases.
     *
     * Example: When aliases `@yii` and `@yii/bootstrap` are defined, classes in the `yii\bootstrap` namespace
     * will be loaded using the `@yii/bootstrap` alias which points to the directory where bootstrap extension
     * files are installed and all classes from other `yii` namespaces will be loaded from the yii framework directory.
     *
     * Also the [guide section on autoloading](guide:concept-autoloading).
     *
     * @param string $className the fully qualified class name without a leading backslash "\"
     * @throws UnknownClassException if the class does not exist in the class file
     */
    public static function autoload($className)
    {
        // 自动加载类
        if (isset(static::$classMap[$className])) {
            // 如果 $classMap 中存在该类,就直接使用
            $classFile = static::$classMap[$className];
            // 如果第一个字符串为'@',就意味着对应的文件地址是别名,就将它转化成真实的文件地址
            if ($classFile[0] === '@') {
                $classFile = static::getAlias($classFile);
            }
        } elseif (strpos($className, '\\') !== false) {
            // 如果存在'\\',就意味着含有 namespace,可以拼成别名,再根据别名获取真实的文件地址
            $classFile = static::getAlias('@' . str_replace('\\', '/', $className) . '.php', false);
            // 没取到真是文件地址或者获取的地址不是一个文件,就返回空
            if ($classFile === false || !is_file($classFile)) {
                return;
            }
        } else {
            return;
        }
        // 引入该类的文件
        include($classFile);
        // 如果是调试模式,而且 $className 即不是类,不是接口,也不是 trait,就抛出异常
        if (YII_DEBUG && !class_exists($className, false) && !interface_exists($className, false) && !trait_exists($className, false)) {
            throw new UnknownClassException("Unable to find '$className' in file: $classFile. Namespace missing?");
        }
    }

其中,大家可能不太清楚 getAlias 方法,这个方法其实就是将 Yii2 中的别名转化成真实的文件地址,关于该方法的具体内容,之后会详细讲解。

举几个例子,帮助大家理解一下。

如果 Yii::$classMap 的值如下:

Yii::$classMap = [
    'app/test/Test' => '/var/www/basic/webtest/Test.php'
];

当你使用 ‘app/test/Test’ 类时,就会自动引入 '/var/www/basic/webtest/Test.php' 文件,项目中的内容当然不是这个样子的,这只是个简单的例子,便于大家理解。

在继续上面的例子,如果你使用了‘yii\base\Component’ 类,它就会转变成 ‘@yii/base/Component.php’ 别名,然后在根据别名获取到它的文件地址,引入进来。

yii 类自动加载(Autoloading)

Yii 依靠类自动加载机制来定位和包含所需的类文件。它提供一个高性能且完美支持PSR-4 标准(中文汉化)的自动加载器。该自动加载器会在引入框架文件 Yii.php 时安装好。

 使用 Yii 自动加载器

要使用 Yii 的类自动加载器,你需要在创建和命名类的时候遵循两个简单的规则:

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

    // $className 是一个开头包含反斜杠的完整类名(译者注:请自行谷歌:fully qualified class name)
    $classFile = Yii::getAlias('@' . str_replace('\\\\', '/', $className) . '.php');

举例来说,若某个类名为 foo\bar\MyClass,对应类的文件路径别名会是 @foo/bar/MyClass.php。为了让该别名能被正确解析为文件路径,@foo 或 @foo/bar 中的一个必须是根别名。

当我们使用基本应用模版时,可以把你的类放置在顶级命名空间 app 下,这样它们就可以被 Yii 自动加载,而无需定义一个新的别名。这是因为 @app 本身是一个预定义别名,且类似于 app\components\MyClass 这样的类名,基于我们刚才所提到的算法,可以正确解析出 AppBasePath/components/MyClass.php 路径。

在高级应用模版里,每一逻辑层级会使用他自己的根别名。比如,前端层会使用 @frontend 而后端层会使用@backend。因此,你可以把前端的类放在 frontend 命名空间,而后端的类放在 backend。 这样这些类就可以被 Yii 自动加载了。

类映射表(Class Map)

Yii 类自动加载器支持类映射表功能,该功能会建立一个从类的名字到类文件路径的映射。当自动加载器加载一个文件时,他首先检查映射表里有没有该类。如果有,对应的文件路径就直接加载了,省掉了进一步的检查。这让类的自动加载变得超级快。事实上所有的 Yii 核心类都是这样加载的。

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

    Yii::$classMap['foo\\bar\\MyClass'] = '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 的自动加载器仍然可以帮你自动加载扩展内的类。

以上是小编为您精心准备的的内容,在的博客、问答、公众号、人物、课程等栏目也有的相关内容,欢迎继续使用右上角搜索按钮进行搜索框架
文件
,以便于您获取更多的相关知识。

时间: 2024-08-05 08:41:13

Yii2框架自动加载机制学习的相关文章

thinkPHP5.0框架自动加载机制分析

本文实例讲述了thinkPHP5.0框架自动加载机制.分享给大家供大家参考,具体如下: 概述 ThinkPHP5.0 真正实现了按需加载,所有类库采用自动加载机制,并且支持类库映射和composer类库的自动加载. 自动加载的实现由think\Loader类库完成,自动加载规范符合PHP的PSR-4. 自动加载 由于新版ThinkPHP完全采用了命名空间的特性,因此只需要给类库正确定义所在的命名空间,而命名空间的路径与类库文件的目录一致,那么就可以实现类的自动加载. 类库的自动加载检测顺序如下:

PHP面向对象自动加载机制原理与用法分析_php技巧

本文实例讲述了PHP面向对象自动加载机制原理与用法.分享给大家供大家参考,具体如下: 在学习PHP的面向对象的时候,会知道很多"语法糖",也就是魔术方法.有一个加自动加载的魔术方法,叫:__autoload(); 先看一段代码 <?php function __autoload($classname) { $filename = "./". $classname .".php"; include_once($filename); } new

PHP autoload与spl_autoload自动加载机制的深入理解_php实例

PHP autoload机制详解(1) autoload机制概述在使用PHP的OO模式开发系统时,通常大家习惯上将每个类的实现都存放在一个单独的文件里,这样会很容易实现对类进行复用,同时将来维护时也很便利.这 也是OO设计的基本思想之一.在PHP5之前,如果需要使用一个类,只需要直接使用include/require将其包含进来即可.下面是一个实际的例 子: 复制代码 代码如下: /* Person.class.php */<?phpclass Person {var $name, $age;f

PHP的autoload自动加载机制使用说明_php技巧

在PHP开发过程中,如果希望从外部引入一个class,通常会使用include和require方法,去把定义这个class的文件包含进来,但是这样可能会使得在引用文件的新脚本中,存在大量的include或require方法调用,如果一时疏忽遗漏则会产生错误,使得代码难以维护. 自PHP5后,引入了__autoload这个拦截器方法,可以自动对class文件进行包含引用,通常我们会这么写: 复制代码 代码如下: function __autoload($className) { include_o

Yaf框架自动加载和路由分发的使用方法

一.自动加载(YafLoader) 1.YafLoader相关的几个配置 PHP运行时配置 yaf.use_namespace 开启命名空间 yaf.use_spl_autoload 开启之后,可由PHP的自动加载函数加载,关闭是为了高效,Yaf只加载一次. yaf.library 全局类库目录路径 Yaf应用配置 application.library 本地类库目录路径 application.library.directory 本地类库目录路径 application.library.nam

PHP的类自动加载机制的笔记

在PHP5之前,各个PHP框架如果要实现类的自动加载,一般都是按照某种约定自己实现一个遍历目录,自动加载所有符合约定规则的文件的类或函数. 当然,PHP5之前对面向对象的支持并不是太好,类的使用也没有现在频繁. 在PHP5后,当加载PHP类时,如果类所在文件没有被包含进来,或者类名出错,Zend引擎会自动调用__autoload 函数.此函数需要用户自己实现__autoload函数. 在PHP5.1.2版本后,可以使用spl_autoload_register函数自定义自动加载处理函数.当没有调

php自动加载机制的深入分析_php技巧

一.php中实现自动加载的方法1.使用require,include,require_once,include_once手工进行加载.2.使用__autoload来进行自动加载3.使用spl的autoload来实现自动加载手工加载的实现: 当需要加载的文件很少的时候我们可以使用第一个来完成.这样做很简单也没问题. 复制代码 代码如下: require_once 'a.php';require_once 'b.php';require_once 'c.php'; 但是当需要加载文件很多的时候这样做

PHP MVC框架之加载器学习笔记

上节说了MVC的路由原理,这节我们来说说MVC框架的loader,也称为加载器. 虽然不同的框架,加载器的用法不同,但是其原理都是相通的...都是通过单例模式加载文件,而且把已加载的文件cache起来,避免重复加载...因为在开发业务的过程中,常常需要加载不同的模块,不同的类库等,MVC的loader可以帮助我们实现单例模式,更加符合开发需求. 下面我们开始动手,利用其原理,做一个简单的loader. 首先,我们设计的加载器,要满足可以全局使用,无论在controller里还是在model.li

CI框架自动加载session出现报错的解决办法_php实例

很多程序员在CI中使用session的时候,开启自动加载session之后网站就报错了,具体错误信息如下:In order to use the Session class you are required to set an encryption key 下面一起来看问题解决办法. 提示信息说明:如果想用session类的话就必须要设置一个加密的密钥!那就给设置一个吧,毕竟也是出于安全考虑. 打开application/config/config.php找到Encryption Key 复制代