[Yii2.0] 以Yii 2.0风格加载自定义类或命名空间 [配置使用Yii2 autoloader]

Yii 2.0最显著的特征之一就是引入了命名空间，所以对于自定义类的引入方式也同以前有所不一样。这篇文章讨论一下如何利用Yii 2.0的自动加载机制，向系统中引入自定义类和命名空间。本文旨在抛砖引玉，若是有理解不当敬请指正，欢迎你们把本身的方法拿出来分享。
咱们但愿被引入的类应该达成一下两点：

1. 在应用中的任这里输入代码意位置可使用该类名或命名空间，而不用显式调用require()/include()。
2. 利用Yii的autoloader，仅在类被调用时加载，以遵循Yii按需加载的原则，节省资源。

咱们使用Yii 2.0基础模板做为演示环境，项目根目录命名为basic（后文中会写成/），这是根目录结构：

basic
├── assets
├── commands
├── config
├── controllers
├── mail
├── models
├── runtime
├── tests
├── vendor
├── views
└── web

加载自定义类

I. 定义类文件

创建目录 /libs 并创建文件Freedom.php。

<?php class Freedom { public static function yell() { echo "I am FREE!"; } }

II. 向Yii::$classMap添加映射

打开配置文件/config/web.php，在文件头部向[[Yii::$classMap]]属性添加类映射。

<?php ... Yii::$classMap['Freedom'] = '@app/libs/Freedom.php'; ... $config = [ ... ]; return $config;

注意： 不要对[[Yii::$classMap]]使用=直接赋值，由于该属性中定义了Yii的一些核心类映射，直接赋值会致使这些映射丢失而Yii autoloader加载不到核心类。No zuo no die don't try.

III. 使用自定义类

见证奇迹的时刻。在系统中尝试调用这个类，咱们使用SiteController::actionIndex()为例。

<?php ... use Freedom; // 别忘了导入这个类，或者在后面调用的时候使用"\Freedom"。 class SiteController extends Controller ... public function actionIndex() { Freedom::yell(); } }

好了，刷新一下试试。

IV. 若是你还关心为何

那如今咱们来须要介绍一下[[Yii::$classMap]]到底是个毛。这货其实是一个关联数组，数组键为“去掉前导反斜线的彻底权限定类名”，对应值为定义了该类的文件路径，其中文件路径支持路径别名。在代码中调用到还没有加载的类时，Yii的audoloader会扫描这个属性以得到须要加载的类文件名。

因此，咱们把刚刚定义的类加入到这个映射数组中，它就能够被Yii延迟加载了。事实上咱们能够在任何位置添加这个映射，只要在目标类被调用以前就能够。应用的主配置文件是一个比较理想的位置，由于配置文件加载在Yii.php以后，能够在其中访问到Yii类（有兴趣的同窗能够去看一下入口脚本），并且配置数据能够集中在一个文件里。

另外，因为咱们定义的类在根命名空间下，因此“去掉前导反斜线的彻底权限定类名”就只剩下Freedom了。若是你的类使用了命名空间，只须要在数组键里写上彻底限定名称就好了(e.g. ['custom\classes\Freedom'])。

---

加载整个命名空间

有时候咱们须要写一组相互关联的类，若是这些类存在依赖关系的话像上面这样给每一个类配置映射会……非(jue)常(b)不(gao)体(si)面(ren)。若是你定义命名空间下的类时遵循 PSR-4 标准，咱们能够一次引入整个命名空间。
此次咱们要使用的属性是[[\yii\base\Application::$aliases]]。它也是一个关联数组，将一个路径别名映射到一个目录或者另外一个已经存在的路径别名。其中数组键是要指定的别名，对应值是目标路径。
咱们只须要在创建一个命名空间别名，把它映射到保存这个命名空间下全部类的根目录，就能够了。固然这个根目录如下的文件结构和类定义要遵循PSR-4，否则autoloader是找不到对应文件的。
试一下：

I. 定义命名空间和类文件

咱们决定在/libs/vendors目录下定义一组以命名空间组织的类，其根目录命名为free-classes，这组类的所有在命名空间free_classes下。注意这里我故意使根目录名与根命名空间名不一致以表示映射根目录不必定要和命名空间同名。
建立文件/libs/vendors/free-classes/persons/Slave.php，没有目录请自行建立。

<?php namespace free_classes\persons; class Slave { public static function isFree() { var_dump("I'm FREE now, thank you!"); } }

建立文件/libs/vendors/free-classes/vehicles/cars/Porsche.php。

<?php namespace free_classes\vehicles\cars; class Porsche { public static function isFree() { var_dump('Are you kidding?!'); } }

注意： free-classes如下的目录名和结构都要遵循PSR-4标准。

II. 配置[[\yii\web\Application::$aliases]]

这里要说一下，若是咱们的命名空间为namespace\subnamespace，那么咱们应该设置的路径别名就是@namespace/subnamespace（详解参照 PSR-4 ）。
打开配置文件/config/web.php，配置Application的aliaes属性：

<?php Yii::$classMap['Freedom'] = '@app/libs/Freedom.php'; ... $config = [ 'id' => 'basic', ... 'aliases' => [ '@free_classes' => '@app/libs/vendors/free-classes' ], ... ]; return $config;

III. 使用命名空间下的类

又要见证奇迹了，仍是选在SiteController::actionIndex()里。

<?php ... use free_classes\persons\Slave; // 仍是别忘了导入 use free_classes\vehicles\cars\Porsche; class SiteController extends Controller ... public function actionIndex() { // Freedom::yell(); Slave::isFree(); Porsche::isFree(); } }

刷新一下;-)