PHP原生不支持s3://协议，需用AWS SDK for PHP的S3Client上传；初始化须配置region、credentials、version；大文件应传fopen句柄并调大超时；必须用ContentMD5校验完整性。
为什么直接用 fopen("s3://...") 会失败
PHP 原生不支持 s3:// 协议的流封装器（除非手动注册并配置 AWS SDK 的 StreamWrapper），直接写 fopen("s3://my-bucket/file.zip", "w") 会报 failed to open stream: No such file or directory。这不是权限或路径问题，而是 PHP 根本没加载对应协议处理器。
正确做法是用 AWS SDK for PHP 的 S3Client 显式上传，它底层走 HTTP/HTTPS 调用 S3 API，和本地文件操作逻辑分离。
安装 SDK 并初始化 S3Client 的最小必要配置
推荐用 Composer 安装：composer require aws/aws-sdk-php。不要下载 ZIP 手动引入——缺少自动加载和依赖管理，容易在 PutObjectCommand 等类上出错。
S3Client 初始化必须包含三项：区域（region）、凭证（credentials）、版本（version）。漏掉 region 会导致 InvalidParameterException: The bucket you are attempting to access must be addressed using the specified endpoint。
- 凭证优先从环境变量读取（
AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY），比硬编码进代码更安全 -
version建议固定为"2006-03-01"（S3 的经典 API 版本），避免用"latest"导致行为突变 - 如果使用 IAM Role（如 EC2 实例），可省略
credentials，SDK 会自动尝试从实例元数据获取
上传文件时如何避免内存溢出和超时
大文件（比如 >50MB）直接用 Body 参数传入 file_get_contents() 会把整个文件读进内存，触发 Allowed memory size exhausted。也不能依赖默认的 60 秒超时——上传百 MB 文件大概率超时。
解决方案是分两步：先用 fopen() 打开本地文件句柄，再传给 Body；同时调大 http 配置：
$client = new S3Client([
'region' => 'us-east-1',
'version' => '2006-03-01',
'http' => [
'timeout' => 300, // 5 分钟
'connect_timeout' => 10,
],
]);
$result = $client->putObject([
'Bucket' => 'my-backup-bucket',
'Key' => 'backups/' . date('Y-m-d_H-i-s') . '.tar.gz',
'Body' => fopen('/path/to/local/backup.tar.gz', 'rb'), // 流式读取
'ACL' => 'private',
]);
注意：fopen() 必须带 rb 模式（二进制只读），否则 Windows 下换行符可能被错误转换，导致文件损坏。
上传后如何验证文件完整性
S3 不保证上传后内容 100% 一致——网络中断、客户端崩溃都可能导致截断。仅靠 $result['@metadata']['statusCode'] === 200 不够。
必须校验 Content-MD5：计算本地文件 MD5 Base64 编码，传给 ContentMD5 参数，S3 会在接收时比对。不匹配则直接返回 400 Bad Request 并提示 BadDigest。
- 用
base64_encode(md5_file($localPath, true))生成值，别用md5_file($localPath)的十六进制字符串 - 这个校验只在单次上传（非分段）中生效；分段上传需用
CompleteMultipartUpload阶段校验 - 上传成功后，可再调一次
headObject()拿回 S3 计算的ETag，但注意：普通上传的ETag就是 MD5，而分段上传的ETag是拼接+MD5，不可直接比对
真正关键的是上传时就让 S3 帮你拦住损坏——这一步漏掉，备份等于白做。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
