tp3.2 自动加载

悠悠 2022-05-24 14:17 177阅读 0赞

在3.2中，基本上无需手动加载类库文件，你可以很方便的完成自动加载。

## 命名空间自动加载 ##

系统可以通过类的命名空间自动定位到类库文件，例如：

我们定义了一个类 `Org\Util\Auth` 类：

1.  `namespace Org\Util;`
2.  `class Auth {`
3.  `}`

保存到 `ThinkPHP/Library/Org/Util/Auth.class.php`。

接下来，我们就可以直接实例化了。

1.  `new \Org\Util\Auth();`

在实例化`Org\Util\Auth`类的时候，系统会自动加载 `ThinkPHP/Library/Org/Util/Auth.class.php` 文件。

框架的Library目录下面的命名空间都可以自动识别和定位，例如：

1.  `├─Library 框架类库目录`
2.  `│ ├─Think 核心Think类库包目录`
3.  `│ ├─Org Org类库包目录`
4.  `│ ├─ ... 更多类库目录`

Library目录下面的子目录都是一个根命名空间，也就是说以Think、Org为根命名空间的类都可以自动加载：

1.  `new Think\Cache\Driver\File();`
2.  `new Org\Util\Auth();`
3.  `new Org\Io\File();`

都可以自动加载对应的类库文件。

> 你可以在Library目录下面任意增加新的目录，就会自动注册成为一个新的根命名空间。

## 注册新的命名空间 ##

除了Library目录下面的命名空间之外，我们还可以注册其他的根命名空间，例如：

1.  `'AUTOLOAD_NAMESPACE' => array(`
2.  `'My' => THINK_PATH.'My',`
3.  `'One' => THINK_PATH.'One',`
4.  `)`

配置了上面的`AUTOLOAD_NAMESPACE`后，如果我们实例化下面的类库

1.  `new My\Net\IpLocation();`
2.  `new One\Util\Log();`

会自动加载对应的类库文件

1.  `ThinkPHP/My/Net/IpLocation.class.php`
2.  `ThinkPHP/One/Util/Log.class.php`

如果命名空间不在Library目录下面，并且没有定义对应的`AUTOLOAD_NAMESPACE`参数的话，则会当作模块的命名空间进行自动加载，例如：

1.  `new Home\Model\UserModel();`
2.  `new Home\Event\UserEvent();`

由于ThinkPHP/Library目录下面不存在Home目录，也没在`AUTOLOAD_NAMESPACE`参数定义Home命名空间，所以就把Home当成模块命名空间来识别，所以会自动加载：

1.  `Application/Home/Model/UserModel.class.php`
2.  `Application/Home/Event/UserEvent.class.php`

> 注意：命名空间的大小写需要和目录名的大小写对应，否则可能会自动加载失败。

## 类库映射 ##

遵循我们上面的命名空间定义规范的话，基本上可以完成类库的自动加载了，但是如果定义了较多的命名空间的话，效率会有所下降，所以，我们可以给常用的类库定义类库映射。命名类库映射相当于给类文件定义了一个别名，效率会比命名空间定位更高效，例如：

1.  `Think\Think::addMap('Think\Log',THINK_PATH.'Think\Log.php');`
2.  `Think\Think::addMap('Org\Util\Array',THINK_PATH.'Org\Util\Array.php');`

也可以利用addMap方法批量导入类库映射定义，例如：

1.  `$map = array('Think\Log'=>THINK_PATH.'Think\Log.php','Org\Util\Array'=>THINK_PATH.'Org\Util\Array.php');`
2.  `Think\Think::addMap($map);`

当然，比较方便的方式是我们可以在模块配置目录下面创建alias.php文件用于定义类库映射，该文件会自动加载，定义方式如下：

1.  `return array(`
2.  `'Think\Log' => THINK_PATH.'Think\Log.php',`
3.  `'Org\Util\Array' => THINK_PATH.'Org\Util\Array.php'`
4.  `);`

## 自动加载的优先级 ##

在实际的应用类库加载过程中，往往会涉及到自动加载的优先级问题，以`Test\MyClass`类为例，自动加载的优先顺序如下：

1.  判断是否有注册了Test\\MyClass类库映射，如果有则自动加载类库映射定义的文件；
2.  判断是否存在Library/Test目录，有则以该目录为初始目录加载；
3.  判断是否有注册Test根命名空间，有则以注册的目录为初始目录加载；
4.  如果以上都不成立，则以Test为模块目录进行初始目录加载；

以上面获取到的初始目录加载命名空间对应路径的文件；

## 手动加载第三方类库 ##

如果要加载第三方类库，包括**不符合命名规范和后缀的类库，以及没有使用命名空间或者命名空间和路径不一致的类库**，或者你就是想手动加载类库文件，我们都可以通过手动导入的方式加载。

我们可以使用import方法导入任何类库，用法如下：

1.  `// 导入Org类库包 Library/Org/Util/Date.class.php类库`
2.  `import("Org.Util.Date");`
3.  `// 导入Home模块下面的 Application/Home/Util/UserUtil.class.php类库`
4.  `import("Home.Util.UserUtil");`
5.  `// 导入当前模块下面的类库`
6.  `import("@.Util.Array");`
7.  `// 导入Vendor类库包 Library/Vendor/Zend/Server.class.php`
8.  `import('Vendor.Zend.Server');`

对于import方法，系统会自动识别导入类库文件的位置，ThinkPHP可以自动识别的类库包包括Think、Org、Com、Behavior和Vendor包，以及Library目录下面的子目录，如果你在Library目录下面创建了一个Test子目录，并且创建了一个UserTest.class.php类库，那么可以这样导入：

1.  `import('Test.UserTest');`

其他的就认为是应用类库导入。

注意，如果你的类库没有使用命名空间定义的话，实例化的时候需要加上根命名空间，例如：

1.  `import('Test.UserTest');`
2.  `$test = new \UserTest();`

按照系统的规则，import方法是无法导入具有点号的类库文件的，因为点号会直接转化成斜线，例如我们定义了一个名称为User.Info.class.php 的文件的话，采用：

1.  `import("Org.User.Info");`

方式加载的话就会出现错误，导致加载的文件不是Org/User.Info.class.php 文件，而是Org/User/Info.class.php 文件，这种情况下，我们可以使用：

1.  `import("Org.User#Info");`

来导入。

大多数情况下，import方法都能够自动识别导入类库文件的位置，如果是特殊情况的导入，需要指定import方法的第二个参数作为起始导入路径。例如，要导入当前文件所在目录下面的 RBAC/AccessDecisionManager.class.php 文件，可以使用：

1.  `import("RBAC.AccessDecisionManager",dirname(__FILE__));`

如果你要导入的类库文件名的后缀不是class.php而是php，那么可以使用import方法的第三个参数指定后缀：

1.  `import("RBAC.AccessDecisionManager",dirname(__FILE__),".php");`

> 注意：在Unix或者Linux主机下面是区别大小写的，所以在使用import方法的时候要注意目录名和类库名称的大小写，否则会导入失败。

如果你的第三方类库都放在Vendor目录下面，并且都以.php为类文件后缀，也没用采用命名空间的话，那么可以使用系统内置的Vendor函数简化导入。 例如，我们把 Zend 的 Filter\\Dir.php 放到 Vendor 目录下面，这个时候 Dir 文件的路径就是 Vendor\\Zend\\Filter\\Dir.php，我们使用vendor 方法导入只需要使用：

1.  `Vendor('Zend.Filter.Dir');`

就可以导入Dir类库了。

Vendor方法也可以支持和import方法一样的基础路径和文件名后缀参数，例如：

1.  `Vendor('Zend.Filter.Dir',dirname(__FILE__),'.class.php');`