Composer自动加载第三方SDK的核心是正确声明autoload配置并确保SDK支持PSR-4或classmap；若无composer.json需手动补全或用files加载。
Composer 自动加载第三方 SDK 的核心是正确声明 autoload 配置，并确保 SDK 本身提供标准 PSR-4 或 classmap 支持；若 SDK 没有自带 composer.json，就得手动补全或用 files 加载。
SDK 已带 composer.json（推荐场景）
绝大多数主流 SDK（如 alibabacloud/sdk、qiniu/php-sdk）已发布到 Packagist，直接 composer require 即可启用自动加载：
- 运行
composer require qiniu/php-sdk:^7.10，Composer 会自动写入vendor/qiniu/php-sdk并合并其autoload规则 - 只要 SDK 的
composer.json中定义了"psr-4": { "Qiniu\": "src/Qiniu/" }，你就能直接new QiniuAuth() - 不需要额外
require或include—— Composer 的 autoloader 已接管
SDK 只有源码包，无 composer.json
比如你下载了一个未打包的微信支付 SDK ZIP，解压后目录为 wechatpay-v3/，内部结构是 src/WechatPay/Client.php，但没 composer.json：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在项目根目录的
composer.json中添加自定义 autoload：
"autoload": {
"psr-4": {
"WechatPay\": "wechatpay-v3/src/WechatPay/"
}
}
- 执行
composer dump-autoload刷新映射 - 注意路径必须是相对于项目根目录的，且结尾不带斜杠；
src/要包含在命名空间路径里（即"WechatPay\" → "wechatpay-v3/src/WechatPay/"） - 如果 SDK 使用全局函数（如
wechatpay_sign()），PSR-4 不生效，得改用"files"方式加载单个 PHP 文件
遇到 Class not found 却确认类名路径都对？检查这三处
常见于 SDK 版本升级或手动移动文件后：
- 运行
composer show qiniu/php-sdk确认实际安装版本，有些旧版 SDK 的命名空间和文档不一致（例如 v6 和 v7 的QiniuStorageUploadManager路径不同） - 检查
vendor/autoload.php是否被正确引入 —— 忘记在入口文件（如index.php）里require 'vendor/autoload.php';是高频错误 - 运行
composer dump-autoload -o强制生成优化后的 classmap（尤其当 SDK 含大量散列小文件时，classmap 比 PSR-4 更快且容错更强）
避免 autoload 冲突：SDK 和你自己代码共用同一名字空间
比如你项目中也定义了 AppHttpControllersWechatController，而某个 SDK 也用了 WechatController 作类名（非标准但存在）：
- Composer 不报错，但运行时可能加载错类 —— 因为 PSR-4 映射是“前缀匹配”，先注册的规则优先
- 解决方法：用
composer config --unset autoload.psr-4."SDK\Name\Space\"临时移除冲突项，或改用files加载 SDK 的特定文件 - 更稳妥的做法：封装一层适配器类，用你自己的命名空间隔离 SDK 原生类，避免直呼其类名
真正容易被忽略的是 autoload 的“缓存可见性”——composer dump-autoload 不会清除已加载的类定义，CLI 下跑一次没问题，但 Web Server（如 Apache + mod_php）可能因 opcache 缓存了旧 autoloader 而不生效，此时需重启服务或清空 opcache。
