《PHP 实现鸿蒙应用文件上传:OBS 预签名直传与后端校验》
上篇消息推送讲完,签到、Token 刷新、限流、错误处理、缓存离线、推送这一圈就闭环了。但真实应用还有一类绕不开的流量:文件。头像、图片、附件、日志包——这些东西如果都从 PHP 中转一遍,带宽、内存和超时都会先撑不住。这篇记录我们最终落地的方案:文件走 OBS 直传,后端只负责签发预签名 URL 和上传后的校验。
一、为什么文件不走 PHP 中转
最朴素的做法是鸿蒙端把文件 POST 给 PHP 接口,PHP 存到服务器磁盘或再转存对象存储。文件小的时候没问题,文件一上来就全是坑:
- PHP 的
upload_max_filesize、post_max_size、执行超时都会卡大文件; - 文件流式经过应用服务器,带宽成本翻倍,还占着 PHP-FPM 进程;
- 转存失败、断点续传、进度展示,全得自己在中转层补。
正确的做法是让客户端直传对象存储:后端签发一个短时有效的预签名 URL,鸿蒙端直接 PUT 到 OBS,文件根本不经过 PHP。PHP 只做两件事——发 URL、验结果。带宽和存储压力都转移到 OBS,应用服务器只处理KB 级的元数据请求。
二、后端签发:预签名 URL 只给一次机会
预签名 URL 的本质是"后端用自己的密钥,替客户端签一张限时、限对象的通行证"。PHP 侧封装一个上传服务:
<?php
class UploadService
{
private ObsClient $obs; // 华为云 OBS SDK 客户端
// 签发预签名 PUT URL,客户端拿去直传
public function createUploadUrl(int $userId, string $fileName, string $contentType): array
{
$ext = strtolower(pathinfo($fileName, PATHINFO_EXTENSION));
// 对象 key 不信客户端传的文件名:用户目录 + 日期 + 随机串
$objectKey = sprintf(
'users/%d/%s/%s.%s',
$userId,
date('Ymd'),
bin2hex(random_bytes(16)),
$ext
);
$url = $this->obs->createSignedUrl([
'Method' => 'PUT',
'Bucket' => 'my-app-files',
'Key' => $objectKey,
'Expires' => 300, // 5 分钟过期,够传完一个文件
'Content-Type' => $contentType,
]);
return [
'upload_url' => $url,
'object_key' => $objectKey,
'expires_in' => 300,
];
}
}
三个关键点:
1. 对象 key 后端生成,不许客户端指定。 文件名是用户可控输入,直接拼路径会带来目录穿越、覆盖别人文件、特殊字符等问题。后端按 用户ID/日期/随机串.扩展名 生成,天然隔离、天然不重名,原始文件名只当展示信息存数据库。
2. 预签名 URL 必须短时有效。 URL 一旦泄露,任何人都能往这个 key 写文件,所以有效期给 5 分钟就够,签发接口本身还要走登录鉴权和限流——别让脚本批量刷预签名 URL。
3. Content-Type 在签发时就定死。 签名里包含 Content-Type,客户端 PUT 时必须带一致的类型,传错直接被 OBS 拒掉;这同时把"声明的类型"和"实际上传的类型"绑定起来,后面校验才有依据。
三、上传完成回调:先验对象,再落库
直传完成后,客户端调一个"上传完成"接口把 object_key 报给后端。后端不要直接信,流程是:
- 用 OBS 的 HEAD 接口查这个对象确实存在,拿到真实的大小和 ETag;
- 校验大小和类型在允许范围内(比如头像 ≤ 2MB、只允许 jpg/png 白名单);
- 通过了才往业务表里插一条文件记录,状态标记为"已上传"。
这一步是幂等的:客户端重试回调时,同一个 object_key 已经落库就直接返回成功,不重复插记录。反过来,没收到回调的孤儿对象(客户端传完就退出了)交给 OBS 生命周期规则定期清理,别让桶里攒垃圾。
四、安全:桶保持私有,下载也走签名
直传方案最容易踩的坑是图省事把桶设成公共读。正确姿势是桶全程私有:
- 上传:预签名 PUT URL,5 分钟过期,一次一个对象;
- 下载:后端按需签发预签名 GET URL(比如 10 分钟),或者前端只拿 object_key,展示时再向后端换短期下载链接;
- 类型校验不只看扩展名:图片类文件在后端或异步任务里重新解码转码一遍,顺手剥掉 EXIF,伪装成图片的脚本文件在转码时就现形了;
- 大小双重限制:签发时约定上限,回调时用 HEAD 拿到的真实大小再验一次——客户端可以绕过前端限制,但绕不过 OBS 里的真实字节数。
五、鸿蒙端配合:进度、取消和大文件分片
端侧直传要补三件事:
- 进度展示:PUT 请求的上传进度直接映射成 UI 进度条,用户能看到传到哪了;
- 可取消、可重试:取消时中断 PUT 并调后端作废这条上传记录;重试时重新签发 URL(旧 URL 可能已过期),但复用同一个 object_key,保证幂等;
- 大文件走分片:超过阈值(比如 20MB)的文件用 OBS 分片上传,断点续传、失败只重传出错的分片,别让一个 200MB 的视频因为 99% 时断网从头再来。小文件单次 PUT,大文件分片,端侧按大小分流。
六、小结
文件上传落地的核心就三句话:
- 文件不走 PHP:后端签发短时预签名 URL,鸿蒙端直传 OBS,应用服务器只处理元数据;
- 回调先验后存:HEAD 查对象、验大小和类型、幂等落库,孤儿对象靠生命周期规则回收;
- 桶保持私有:上传下载都走签名 URL,类型校验看真实内容不看扩展名。
加上前面几篇的签到、Token 刷新、限流、错误处理、缓存离线和消息推送,鸿蒙端云一体应用从接口、数据到文件和触达就完整了。后面有新的实践再继续分享。
- 点赞
- 收藏
- 关注作者
评论(0)