PHP上传音频到S3必须使用aws/aws-sdk-php v3，小文件（≤5MB）用putObject()并显式设ContentType，大文件（>5MB）须用upload()自动分片上传，且需配置CORS支持前端播放。
PHP上传音频到S3前，先确认你用的是v3 SDK
PHP官方推荐且唯一维护的AWS SDK是 aws/aws-sdk-php v3，v2已废弃。如果你还在用 AmazonS3 类或 get_instance()，说明你卡在旧文档里了——立刻卸载旧包，用Composer装新版：
composer require aws/aws-sdk-php
旧SDK不支持现代认证方式（如IAM Roles for EC2/ECS），也缺少对Multipart Upload的简洁封装，音频文件稍大（>5MB）就容易超时失败。
用 putObject() 传小音频（≤5MB），注意MIME类型和路径
直接读取音频文件内容并上传最简单，但必须显式指定 ContentType，否则S3默认存为 binary/octet-stream，前端无法自动播放：
$s3 = new Aws\S3\S3Client([
'version' => 'latest',
'region' => 'us-east-1',
'credentials' => [
'key' => 'YOUR_ACCESS_KEY',
'secret' => 'YOUR_SECRET_KEY',
],
]);
$audioPath = $_FILES['audio']['tmp_name'];
$audioName = basename($_FILES['audio']['name']); // 如 "voice.mp3"
// 根据扩展名推断Content-Type（别硬写死）
$contentType = match (pathinfo($audioName, PATHINFO_EXTENSION)) {
'mp3' => 'audio/mpeg',
'wav' => 'audio/wav',
'ogg' => 'audio/ogg',
'm4a' => 'audio/mp4',
default => 'application/octet-stream',
};
$s3->putObject([
'Bucket' => 'your-audio-bucket',
'Key' => 'uploads/' . uniqid() . '-' . $audioName,
'Body' => fopen($audioPath, 'r'),
'ContentType' => $contentType,
'ACL' => 'public-read', // 如需直链访问
]);
- 不要用
file_get_contents()加载大文件到内存，fopen()流式读取更安全 -
Key中避免用户可控的原始文件名直接拼接（防路径遍历），加uniqid()或UUID前缀 - 如果S3返回
AccessDenied，不是密钥错，而是IAM策略没授权s3:PutObject和对应Resource路径
上传大音频（>5MB）必须用 upload() + 分段上传
单次 putObject() 默认有100MB限制，且网络中断就全盘重传。v3 SDK的 upload() 方法会自动切片、并发上传、断点续传：
立即学习“PHP免费学习笔记（深入）”；
$result = $s3->upload(
'your-audio-bucket',
'uploads/large-' . $audioName,
fopen($audioPath, 'r'),
'public-read',
[
'params' => ['ContentType' => $contentType],
'concurrency' => 3, // 并发数，别设太高（EC2小实例易OOM）
]
);
关键点：
- 它底层调用
CreateMultipartUpload→ 多个UploadPart→CompleteMultipartUpload，全程自动管理 - 上传中若失败，SDK会重试（默认3次），但不会自动清理已上传的Part——长期积压会产生成本
- 如果PHP进程被Nginx超时kill（常见于上传慢网络），得配合前端用预签名URL分段上传，后端只管接收Part
本地开发时，AWS_ENDPOINT 和CORS配置最容易漏
用MinIO或LocalStack测试？必须显式设置 endpoint 和禁用SSL验证（否则cURL报错）：
$s3 = new Aws\S3\S3Client([
'version' => 'latest',
'region' => 'us-east-1',
'endpoint' => 'http://localhost:9000',
'use_path_style_endpoint' => true,
'http' => ['verify' => false], // 仅开发环境
'credentials' => [...],
]);
而真实S3上，音频要能被网页直接 <audio src="https://...>%20%E6%92%AD%E6%94%BE%EF%BC%8CBucket%E5%BF%85%E9%A1%BB%E9%85%8DCORS%E8%A7%84%E5%88%99%EF%BC%9A
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "HEAD"],
"AllowedOrigins": ["https://your-site.com"],
"ExposeHeaders": ["ETag"]
}
]%0A%E6%BC%8F%E6%8E%89CORS%EF%BC%8C%E6%B5%8F%E8%A7%88%E5%99%A8%E6%8E%A7%E5%88%B6%E5%8F%B0%E4%BC%9A%E6%8A%A5%20No%20'Access-Control-Allow-Origin'%20header%EF%BC%8C%E4%BD%86S3%E4%B8%8A%E4%BC%A0%E6%9C%AC%E8%BA%AB%E6%98%AF%E6%88%90%E5%8A%9F%E7%9A%84%E2%80%94%E2%80%94%E8%BF%99%E4%B8%AA%E9%94%99%E8%AF%AF%E4%B8%8D%E5%8F%91%E7%94%9F%E5%9C%A8PHP%E4%BE%A7%EF%BC%8C%E5%BE%88%E5%AE%B9%E6%98%93%E8%AF%AF%E5%88%A4%E4%B8%BA%E4%B8%8A%E4%BC%A0%E5%A4%B1%E8%B4%A5%E3%80%82
