• Yii2的深入学习--自动加载机制(转)


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

    Composer自动加载

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

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

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

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

    可查阅资料:

    1. Composer 自动加载
    2. Composer 自动加载-参考
    3. 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 [[yiiBaseYii]] which provides the actual implementation.
     * By writing your own Yii class, you can customize some functionalities of [[yiiBaseYii]].
     *
     * @author Qiang Xue <qiang.xue@gmail.com>
     * @since 2.0
     */
    class Yii extends yiiBaseYii
    {
    }
    
    /**
     * 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 函数,实现自动加载, 其实现在 yiiBaseYii 中
     */
    spl_autoload_register(['Yii', 'autoload'], true, true);
    // 定义 Yii 核心的 class 的类名与文件地址的 Map
    Yii::$classMap = require(__DIR__ . '/classes.php');
    // 创建 Yii 的依赖注入的容器
    Yii::$container = new yiidiContainer();
    复制代码

    其主要内容就是引入了 BaseYii.php 文件,然后声明了类 Yii,继承了 BaseYii,然后注册了 Yii (其实是 BaseYii)的 autoload 方法,去实现自动加载。之后又引入了Yii 核心类名与文件地址一一对应的 Map,存储到 Yii::$classMap 中。最后创建了一个 yiidiContainer 的实例,存储到 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. `yiiaseComponent`), 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 `yiiootstrap` 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' 文件,项目中的内容当然不是这个样子的,这只是个简单的例子,便于大家理解。

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

    以上就是 Yii2 的自动加载机制的基本内容~~

    对 Yii2 源码有兴趣的同学可以关注项目 yii2-2.0.3-annotated,现在在上面已经添加了不少关于 Yii2 源码的注释,之后还会继续添加~

    有兴趣的同学也可以参与进来,提交 Yii2 源码的注释。

  • 相关阅读:
    ELK学习总结(2-1)mavel -》sense 和 索引初始化
    ELK学习总结(1-3)倒排索引
    java基础总结(1)安装jdk
    ELK学习总结(1-2)安装ElasticSearch
    T410升级笔记
    CURL学习总结(1)
    restful架构风格设计准则(二)以资源为中心,一个url
    GIT入门笔记(18)- 标签创建和管理
    GIT入门笔记(17)- 创建分支dev_lsq, 提交到代码
    GIT入门笔记(16)- 分支创建和管理
  • 原文地址:https://www.cnblogs.com/sandea/p/5616523.html
Copyright © 2020-2023  润新知