关于THINKPHP5种如何引入第三方的类文件
tp5的模型虽然是固定的,但是很多人会建不同的目录结构,有的为了访问方式,有的是为了restful风格,所以引用三方包的时候 ,路径方式也不同,下面列出几种经常用到的:
自动加载
ThinkPHP5.0
真正实现了按需加载,所有类库采用自动加载机制,并且支持类库映射和composer
类库的自动加载。
自动加载的实现由think\Loader
类库完成,自动加载规范符合PHP的PSR-4
。
自动加载
由于新版ThinkPHP
完全采用了命名空间的特性,因此只需要给类库正确定义所在的命名空间,而命名空间的路径与类库文件的目录一致,那么就可以实现类的自动加载。
类库的自动加载检测顺序如下:
1、类库映射检测;
2、PSR-4
自动加载检测;
3、PSR-0
自动加载检测;
系统会按顺序检测,一旦检测生效的话,就会自动载入对应的类库文件。
类库映射
遵循我们上面的命名空间定义规范的话,基本上可以完成类库的自动加载了,但是如果定义了较多的命名空间的话,效率会有所下降,所以,我们可以给常用的类库定义类库映射。命名类库映射相当于给类文件定义了一个别名,效率会比命名空间定位更高效,例如:
Loader::addClassMap('think\Log',LIB_PATH.'think\Log.php');
Loader::addClassMap('org\util\Array',LIB_PATH.'org\util\Array.php');
也可以利用addClassMap
方法批量导入类库映射定义,例如:
$map = [
'think\Log' => LIB_PATH.'think\Log.php',
'org\util\array'=> LIB_PATH.'org\util\Array.php'
];
Loader::addClassMap($map);
虽然通过类库映射的方式注册的类可以不强制要求对应命名空间目录,但是仍然建议遵循PSR-4规范定义类库和目录。
类库导入
如果你不需要系统的自动加载功能,又或者没有使用命名空间的话,那么也可以使用think\Loader
类的import
方法手动加载类库文件,例如:
Loader::import('org.util.array'); //import 进入 输入 导入 汇入
Loader::import('@.util.upload');
示例
// 引入 extend/qrcode.php
Loader::import('qrcode', EXTEND_PATH);
// 助手函数
import('qrcode', EXTEND_PATH);
// 引入 extend/wechat-sdk/wechat.class.php
Loader::import('wechat-sdk.wechat', EXTEND_PATH, '.class.php');
// 助手函数
import('wechat-sdk.wechat', EXTEND_PATH, '.class.php');
类库导入也采用类似命名空间的概念(但不需要实际的命名空间支持),支持的“根命名空间”包括:
目录 | 说明 |
---|---|
behavior | 系统行为类库 |
think | 核心基类库 |
traits | 系统Traits类库 |
app | 应用类库 |
@ | 表示当前模块类库包 |
traits 特质 特征 性态 特性
如果完全遵从系统的命名空间定义的话,一般来说无需手动加载类库文件,直接实例化即可。
ThinkPHP5.0
不推荐使用import
方法。
Composer自动加载
5.0版本支持Composer
安装的类库的自动加载,你可以直接按照Composer
依赖库中的命名空间直接调用。