首选 Composer 引入 SDK：执行 composer require aliyuncs/oss-sdk-php:^2.6，确保 autoload 生效；控制器中需显式 require_once VENDOR_PATH . '/autoload.php' 并用完整命名空间实例化 OssClient。
确认 SDK 引入方式：用 composer 还是手动加载？
ThinkPHP 5.0.22 默认不带自动加载机制，composer 是首选——它能正确处理命名空间和依赖，避免 Class not found 错误。手动复制 SDK 到 vendor 或 Library/Vendor 后再 require_once，容易因路径、命名空间或 autoload 顺序出问题，尤其在 CLI 环境下常报 OSS\OssClient 找不到。
实操建议：
- 执行
composer require aliyuncs/oss-sdk-php:^2.6（^2.6兼容 TP5.0.x，新版v3+需 PHP 7.4+，TP5.0.22 常配 PHP 7.2） - 确保项目根目录有
composer.json且已运行过composer install - 不要删掉
vendor/autoload.php，TP5.0.22 的thinkphp/start.php会自动包含它
控制器里怎么写才能不报 OSS\OssClient 类不存在？
常见错误是只写了 use OSS\OssClient; 却没加载 SDK 的 autoload —— 即使你用了 composer，也得确认自动加载生效。TP5.0.22 的 vendor/autoload.php 通常已由框架入口包含，但如果你在非标准入口（比如命令行脚本或自定义路由）中调用，可能漏了。
安全写法（显式兜底）：
立即学习“PHP免费学习笔记（深入）”；
- 在控制器顶部加
require_once VENDOR_PATH . '/autoload.php';（VENDOR_PATH是 TP 定义的常量，指向vendor目录） - 然后写
use OSS\OssClient;和use OSS\Core\OssException; - 实例化时用完整命名空间：
$ossClient = new \OSS\OssClient($accessKeyId, $accessKeySecret, $endpoint);，避免与本地类冲突
uploadFile() 和 putObject() 该选哪个？
两者都能传文件，但行为差异直接影响稳定性：
-
uploadFile($bucket, $object, $localFile)：直接读磁盘文件，要求$localFile是绝对路径字符串（如/var/www/html/runtime/file.jpg），内部自动处理分片，适合大文件（>100MB） -
putObject($bucket, $object, $content)：接受资源句柄（resource）或字符串内容；上传 ThinkPHP 的$file->getTmpName()时必须用fopen($file->getTmpName(), 'rb')包一层，否则 Windows 下可能乱码或截断 - TP5.0.22 的
$file->getTmpName()返回的是临时文件路径字符串，不能直接塞给putObject—— 必须转成 resource，否则报Invalid argument supplied for foreach()或静默失败
环境变量和配置怎么管才不容易出错？
硬编码 $accessKeyId 在代码里是高危操作，但 TP5.0.22 没有内置的 .env 支持（那是 TP6+ 的特性），所以得自己垫一层。
推荐做法：
- 在
config/alioss.php中定义数组，字段名用小写（避免大小写敏感问题）：return ['access_key_id' => getenv('OSS_ACCESS_KEY_ID') ?: '', ...]; - 在控制器中用
config('alioss.access_key_id')读取，而不是直接读$_ENV（某些 SAPI 下$_ENV是空的） - 注意
endpoint格式：必须是纯域名（如oss-cn-hangzhou.aliyuncs.com），不能带http://或https://，否则OssClient构造时会拼出双协议 URL 导致连接失败
最易被忽略的一点：TP5.0.22 的 config() 函数默认不支持多维数组键名嵌套写法（如 config('alioss.access_key_id')），需确认你的配置文件返回的是扁平数组，或改用 Config::get('alioss.access_key_id') 调用。
