ThinkPHP引入第三方类库需按来源和版本选择路径配置：TP6+以Composer为核心，标准库直接use；自定义工具类须PSR-4注册并dump-autoload；手动SDK放extend/并require_once；旧版兼容用Vendor+Loader::import。
ThinkPHP 引入第三方类库，路径配置方式取决于类库来源和框架版本。TP6+ 以 Composer 为核心机制，而 TP5 或旧版仍保留 extend/Vendor 等传统路径支持。关键不是“随便放哪再 require”，而是让自动加载能精准定位到类——路径配错，Class not found 就必然出现。
Composer 安装的标准库：无需手动配路径
通过 composer require vendor/package 安装的包（如 guzzlehttp/guzzle、monolog/monolog），Composer 已将其注册进 vendor/autoload.php。只要入口文件（如 public/index.php）已正确引入该文件：
- 直接
use包声明的命名空间即可使用，例如use GuzzleHttpClient; - 无需修改
composer.jsonautoload 段，也不用执行dump-autoload - 框架启动时会自动读取 Composer 的完整加载规则，包括 PSR-4、PSR-0、classmap 和 files
自定义工具类（app/utils、app/common 等）：必须 PSR-4 显式注册
你自己写的类，比如 app/utils/ArrHelper.php，即使放在 app/ 下也不会被自动识别，因为 TP6 不扫描目录，只认 Composer 配置。
- 打开项目根目录
composer.json，在"autoload": {"psr-4": {}}中添加映射："app\utils\": "app/utils/"（注意双反斜杠、末尾正斜杠） - 确保类文件名与类名严格一致且大小写敏感，
class ArrHelper→ 必须叫ArrHelper.php - 保存后运行：
composer dump-autoload -o（-o参数不可省，否则开发中常因优化缓存未更新而失效）
手动下载的 SDK（百度 AIP、腾讯 COS、支付宝等）：走 extend/ + require_once
这类 SDK 通常无 composer.json，不遵循 PSR 标准，不能指望自动加载。最稳妥的做法是放入 extend/ 并显式引入。
立即学习“PHP免费学习笔记（深入）”；
- 将 SDK 整个文件夹解压到
extend/aipbaidusdk/，确保AipNlp.php在该目录下 - 在控制器或服务中写：
require_once EXTEND_PATH . 'aipbaidusdk/AipNlp.php'; - 若 SDK 内部有命名空间且结构规范（如
namespace Aip;），也可按命名空间方式实例化：$nlp = new AipAipNlp(...);
旧版兼容路径（TP5 及部分 TP6 扩展场景）：Vendor 目录与 Loader::import
对于历史项目或需快速集成无命名空间的老 SDK（如 FCKeditor、早期支付宝 SDK），仍可沿用 Vendor 路径 + 手动加载。
- 把 SDK 放入
extend/Vendor/Alipay/或extend/Vendor/FCKeditor/ - 用
Loader::import()加载（TP5）或助手函数import()：import('Alipay.lib.alipayapi', EXTEND_PATH); - 调用时注意命名空间是否匹配目录结构；若无命名空间，类名即全局名，如
new lipayapi();
