《PHP 实现鸿蒙应用文件上传:OBS 预签名直传与后端校验》

举报
yd_263909811 发表于 2026/11/14 07:07:45 2026/11/14
【摘要】 上篇消息推送讲完,签到、Token 刷新、限流、错误处理、缓存离线、推送这一圈就闭环了。但真实应用还有一类绕不开的流量:文件。头像、图片、附件、日志包——这些东西如果都从 PHP 中转一遍,带宽、内存和超时都会先撑不住。这篇记录我们最终落地的方案:文件走 OBS 直传,后端只负责签发预签名 URL 和上传后的校验。 一、为什么文件不走 PHP 中转最朴素的做法是鸿蒙端把文件 POST 给 P...

上篇消息推送讲完,签到、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 报给后端。后端不要直接信,流程是:

  1. 用 OBS 的 HEAD 接口查这个对象确实存在,拿到真实的大小和 ETag;
  2. 校验大小和类型在允许范围内(比如头像 ≤ 2MB、只允许 jpg/png 白名单);
  3. 通过了才往业务表里插一条文件记录,状态标记为"已上传"。

这一步是幂等的:客户端重试回调时,同一个 object_key 已经落库就直接返回成功,不重复插记录。反过来,没收到回调的孤儿对象(客户端传完就退出了)交给 OBS 生命周期规则定期清理,别让桶里攒垃圾。

四、安全:桶保持私有,下载也走签名

直传方案最容易踩的坑是图省事把桶设成公共读。正确姿势是桶全程私有:

  • 上传:预签名 PUT URL,5 分钟过期,一次一个对象;
  • 下载:后端按需签发预签名 GET URL(比如 10 分钟),或者前端只拿 object_key,展示时再向后端换短期下载链接;
  • 类型校验不只看扩展名:图片类文件在后端或异步任务里重新解码转码一遍,顺手剥掉 EXIF,伪装成图片的脚本文件在转码时就现形了;
  • 大小双重限制:签发时约定上限,回调时用 HEAD 拿到的真实大小再验一次——客户端可以绕过前端限制,但绕不过 OBS 里的真实字节数。

五、鸿蒙端配合:进度、取消和大文件分片

端侧直传要补三件事:

  1. 进度展示:PUT 请求的上传进度直接映射成 UI 进度条,用户能看到传到哪了;
  2. 可取消、可重试:取消时中断 PUT 并调后端作废这条上传记录;重试时重新签发 URL(旧 URL 可能已过期),但复用同一个 object_key,保证幂等;
  3. 大文件走分片:超过阈值(比如 20MB)的文件用 OBS 分片上传,断点续传、失败只重传出错的分片,别让一个 200MB 的视频因为 99% 时断网从头再来。小文件单次 PUT,大文件分片,端侧按大小分流。

六、小结

文件上传落地的核心就三句话:

  1. 文件不走 PHP:后端签发短时预签名 URL,鸿蒙端直传 OBS,应用服务器只处理元数据;
  2. 回调先验后存:HEAD 查对象、验大小和类型、幂等落库,孤儿对象靠生命周期规则回收;
  3. 桶保持私有:上传下载都走签名 URL,类型校验看真实内容不看扩展名。

加上前面几篇的签到、Token 刷新、限流、错误处理、缓存离线和消息推送,鸿蒙端云一体应用从接口、数据到文件和触达就完整了。后面有新的实践再继续分享。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。