类自动加载(Autoloading)

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

    • 每个类都必须置于命名空间之下 (比如 foo\bar\MyClass)。

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

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

    要将自定义命名空间添加到自动加载器,您需要使用 [[Yii::setAlias()]] 为命名空间的根目录定义别名。
    例如,要加载位于 目录中 foo 命名空间中的类,您将调用 Yii::setAlias('', 'path/to/foo')

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

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

    别名可以被用于指定类文件的路径。你应该在的过程中设置类映射表,
    这样映射表就可以在你使用具体类之前就准备好。

    当你同时使用其他自动加载器和 Yii 自动加载器时,应该在其他自动加载器安装成功之后
    再包含 Yii.php 文件。这将使 Yii 成为第一个响应任何类自动加载请求的自动加载器。
    举例来说,以下代码提取自基本应用模版

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

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

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

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