ThinkPHP 8.0 引入第三方类库必须通过 Composer PSR-4 自动加载，禁用手动 require/vendor；官方 SDK 直接 composer require 即可；非 Composer 包放 extend/ 并 require_once；自定义工具类需在 composer.json 中声明 PSR-4 映射并执行 composer dump-autoload -o。
ThinkPHP 8.0 引入第三方类库，核心原则就一条：**必须走 Composer 自动加载机制，手动 require 或 vendor() 已失效**。TP8 彻底移除了 ThinkPHP 3.x/5.x 那套 import/vendor 导入逻辑，也不再支持 Vendor 目录自动扫描。类找不到？八成是没进 Composer 的 PSR-4 加载轨道。
用 Composer 安装并注册（推荐且主流）
绝大多数现代 SDK（如 Guzzle、Monolog、腾讯云 COS SDK、阿里云 OSS SDK）都已发布 Composer 包。直接安装即可被自动识别：
- 运行命令：
composer require qcloud/cos-sdk-v5或composer require guzzlehttp/guzzle - 安装后无需额外配置——只要包本身遵循 PSR-4 规范（99% 的官方 SDK 都遵循），Composer 会自动将其映射到命名空间
- 在代码中直接 new 或 use 对应类，例如：
use QcloudCosClient;、$client = new Client([...]); - 验证是否生效：执行
composer dump-autoload -o，再检查vendor/composer/autoload_psr4.php中是否已写入该包的命名空间路径
手动引入非 Composer 包（如老 SDK、内部工具包）
若你拿到的是 ZIP 包、无 composer.json 的 PHP 文件集合（如某银行私有 SDK），不能丢进 Vendor 或 Library，而应放入 extend/ 目录并显式加载：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 将 SDK 整个文件夹解压至
extend/bank-sdk/，确保AesUtil.php在该目录下 - 在控制器或服务中使用：
require_once EXTEND_PATH . 'bank-sdk/AesUtil.php'; - 注意：
EXTEND_PATH是 TP8 内置常量，指向extend/目录绝对路径；不要用相对路径或硬编码 - 这类文件不参与自动加载，所以类名与文件名不必严格匹配 PSR-4，但需确保
require_once执行时机早于首次使用
自定义工具类要进 PSR-4 白名单
你自己写的通用类（比如 app/utils/HttpHelper.php），TP8 不会“猜”它在哪。必须主动告诉 Composer：
立即学习“PHP免费学习笔记（深入）”；
- 打开项目根目录
composer.json，在"autoload": {"psr-4": {}}中添加："app\utils\": "app/utils/"（注意双反斜杠、末尾正斜杠） - 类文件必须与类名一致且大小写敏感：类
HttpHelper→ 文件名必须是HttpHelper.php - 改完立即执行：
composer dump-autoload -o（-o参数不可省，否则开发中易因缓存失效导致类找不到）
避坑提醒：这些操作已无效或危险
以下方式在 TP8 中不再支持，强行使用会导致类找不到或运行时崩溃：
- 调用
vendor()或import()函数（函数已被删除） - 把类库扔进
Library/Vendor/或ThinkPHP/Library/Vendor/（该路径不存在于 TP8） - 在控制器里写
require '../extend/sdk/xxx.php'（路径不可靠，且可能重复加载） - 删掉
vendor/autoload.php改用其他自动加载器（TP8 启动强依赖它）
