在阿里云部署 PHP 网站,上传头像、商品图片或业务附件时,文件可以保存在云服务器,也可以存入对象存储 OSS。文件量不大、只供后台人员使用时,本地存储比较直接;文件持续增加,或需要从多台服务器访问时,OSS 更容易管理。选择时还要考虑文件是否私密、怎样备份,以及后续扩容会不会影响现有业务。
根据文件用途选择存储位置
保存到云服务器:PHP 接收文件后,将它移动到指定目录。这种方式配置简单,适合开发测试或少量后台附件。不过,文件会占用系统盘或数据盘空间。服务器迁移、扩容和备份时,文件也需要一并处理;如果多个应用实例需要读取同一份文件,还要考虑同步问题。
保存到 OSS:文件放在对象存储中,PHP 负责校验文件并上传,或为前端签发受限的上传凭证。图片、视频、文档等文件持续增长时,OSS 通常更方便管理,也便于结合 CDN 分发。上传凭证和访问权限需要单独配置,不能把 AccessKey 放在网页代码或公开仓库里。
比如,预约服务网站刚上线时只有少量用户头像,可以先存到服务器的非公开目录。等门店开始上传商品图片,文件数量和访问量上来后,再迁移到 OSS,并让业务数据库保存对象键或访问地址。这样调整时,应用逻辑和文件存储不会绑得太死。
服务器本地上传:校验后再保存
PHP 接收表单文件时,会先把它放进临时目录。应用需要检查上传状态、文件大小和类型,通过后再调用 move_uploaded_file() 移到目标位置。HTML 表单要设置 enctype="multipart/form-data",文件字段名也必须和 PHP 读取的名称一致。
处理时,可以先确认 $_FILES['file'] 存在且错误码为 UPLOAD_ERR_OK,再限制大小,例如不超过 5MB。类型判断不要只看文件扩展名,可以用 finfo_file() 检测实际 MIME 类型,并只接受业务允许的格式,例如 image/jpeg 和 image/png。确认通过后生成随机文件名,再调用 move_uploaded_file($file['tmp_name'], $targetPath)。实际代码还应处理登录状态、目录创建失败和写入失败等情况。
不要把用户提供的原始文件名直接拼进保存路径。文件名可能包含特殊字符,也可能覆盖已有文件。可以用 bin2hex(random_bytes(16)) 生成随机名称,再根据已经确认的文件类型添加扩展名。保存目录由服务端配置,不能允许用户通过表单指定任意路径。
上传大小还受 PHP 和 Web 服务器配置影响。检查 php.ini 里的 upload_max_filesize、post_max_size 和 max_file_uploads。post_max_size 通常要大于单个文件的大小限制,因为请求中还包含其他表单数据。使用 Nginx 时,也要核对 client_max_body_size。修改配置后按需重启 PHP-FPM 或 Web 服务,并分别测试小文件和接近限制的文件。
使用 OSS:凭证留在服务端
PHP 可以通过阿里云 OSS PHP SDK 上传文件。常见做法是用 Composer 安装 SDK,在服务端配置地域、Bucket 和凭证,再调用上传接口。上传成功后,将对象键或访问地址写入业务数据库;页面需要展示文件时,再根据访问权限生成可用地址。SDK 版本和初始化参数可能随版本变化,实施时应对照阿里云官方文档中的对应版本。
上传流程可以按这个顺序组织:先读取并验证文件,再生成不易猜测的对象键,例如 uploads/日期/随机字符串;通过 SDK 上传临时文件;确认成功后,才把对象键写入数据库。上传失败时返回清楚的错误信息,不要把尚未成功的对象地址保存为有效记录。文件较大时,可以评估分片上传,减少单次请求过大造成超时的风险。
AccessKey 不要放在 JavaScript、公开代码仓库或可下载的配置文件中。服务器调用 OSS 时,优先使用云环境支持的角色授权;必须使用长期凭证时,应放在环境变量或受控配置中,并只授予业务所需权限。如果由浏览器直传 OSS,应由 PHP 服务端签发短时凭证,并限制可上传的目录和文件大小。永久密钥不能交给浏览器。
权限设置与常见故障排查
- 同时校验类型和大小:扩展名可以被随意修改,不能单独作为判断依据。应结合 MIME 检测、业务允许列表和大小限制;涉及高风险文件时,可增加病毒扫描。
- 防止上传文件被执行:本地文件优先保存到网站根目录之外。确实需要放在 Web 目录时,要配置禁止脚本执行,并避免让用户提供的路径直接决定访问位置。
- 按文件用途设置访问权限:用户隐私文件不宜设为公共读。可以使用私有 Bucket,在用户通过权限校验后再生成短时签名 URL。
- 从日志和配置逐项排查:查看 PHP 上传错误码、PHP-FPM 和 Nginx 日志,同时检查请求大小限制、临时目录空间、目标目录权限,以及 OSS 地域、Bucket 名称和授权范围。
如果测试环境能上传 2MB 图片,生产环境却提示请求过大,问题可能出在 Nginx 或 PHP 的请求上限,而不是移动文件的代码。若文件已经上传,但图片无法访问,应检查 OSS 读权限、对象地址和跨域设置。为了方便访问就把整个 Bucket 改成公共读,可能会让原本私密的文件也暴露出去。
上线前逐项核对
上线前确认文件存在哪里、谁可以访问;上传类型和大小是否有限制;文件名是否由服务端生成;凭证是否只保存在服务端;PHP、Nginx 与 OSS 的配置是否匹配。还要准备好失败日志和用户能看懂的提示,并为重要文件安排备份或生命周期管理策略。
阿里云 PHP 上传文件需要一起考虑存储、访问权限和后续维护。小项目可以先用本地存储验证流程,但要把目录权限和磁盘容量管好;文件增加或需要多实例共享时,再迁移到 OSS。按业务变化调整,比在上线初期就加入用不到的复杂功能更容易维护。