thinkphp图片必须改用oss直传+cdn加速，因本地存储会导致io和php-fpm过载；uploadfile()->move()不能直接对接oss，因其先写临时目录再读取，造成冗余i/o且tmp_name易被清理失效；应使用fopen($file->gettmpname(), 'rb')获取流句柄直传，配合aliyuncs/oss-sdk-php:^3.0及正确配置endpoint、bucket、url与cors。
ThinkPHP项目图片不能继续存本地，否则一上量就拖垮服务器 IO 和 PHP-FPM；OSS 直传 + CDN 加速不是“可选项”，是必须落地的存储路径重构。
为什么 uploadFile()->move() 不能直接对接 OSS
默认的 move() 会把文件先写入 runtime/upload/ 临时目录，再手动读取上传——多一次磁盘 I/O，且 tmp_name 在请求结束时可能已被 PHP-FPM 清理，file_get_contents($_FILES['file']['tmp_name']) 极易失败。
- 真正要的是流式直传：用
fopen($file->getTmpName(), 'rb')拿到 resource 句柄，直接喂给 OSS SDK - 必须用
aliyuncs/oss-sdk-php:^3.0（v2 不支持 stream 参数） -
'rb'模式不能省，Windows 下缺它会损坏二进制文件 - 别在控制器里 new OssClient —— 配置应从
$_ENV或config/filesystems.php读，避免硬编码密钥
如何配置 ThinkPHP 6 的 OSS 磁盘并确保 URL 可访问
直接改 config/filesystem.php 的 disks 数组，不要试图 patch 核心类：
- 装包：
composer require aliyuncs/oss-sdk-php（官方 SDK）或更省心的composer require overtrue/flysystem-oss - endpoint 必须带协议，如
https://oss-cn-beijing.aliyuncs.com；若用了 CNAME 域名（如https://cdn.example.com），is_cname设为true - bucket 权限至少开「公共读」，否则前端访问返回 403；如需私有访问，必须走
signUrl()生成临时链接 -
url字段必须显式配置，否则Storage::disk('oss')->url()会拼出内网 endpoint，例如：'url' => 'https://' . env('ALIYUN_OSS_BUCKET') . '.' . env('ALIYUN_OSS_ENDPOINT')
CDN 回源和模板资源路径怎么不踩坑
CDN 加速失效，90% 是因为回源路径或模板引用没对齐：
- Nginx/Apache 根目录必须指向
public/，CDN 回源地址填/public（阿里云需带尾部斜杠，腾讯云建议不带，以curl -I https://your-cdn.com/static/logo.png返回 200 为准） - 所有静态资源必须用
{:asset('images/logo.png')}，而不是硬写/static/images/logo.png - 在
config/app.php配'asset_host' => env('CDN_URL', '')，.env写CDN_URL=https://cdn.example.com；开发环境留空自动回退到本地 - 别在
build.php里用相对路径如./public/static，sourcePath 必须是public/static（无点无斜杠开头）
上传成功但用户看不到图？检查这三处
常见假成功场景：接口返回 200，数据库写了记录，但前端加载的是 404 或 403 图片。
- OSS bucket 的「跨域设置（CORS）」没开：必须添加允许
*或指定域名的Origin，且AllowedMethod包含GET - 服务器本地时间偏差超过 15 分钟，OSS 拒绝签名，错误是
RequestExpired；执行ntpdate -u ntp.aliyun.com校时 - ThinkPHP 的
Storage::disk('oss')->put()默认会ltrim($path, '/')，传/uploads/1.jpg实际存成uploads/1.jpg，但前端拼 URL 时可能多加了一层/，导致路径错位
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
