类自动加载(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
的更多细节。