怎么用PHP将音频上传到S3-php教程-PHP中文网

PHP上传音频到S3必须使用aws/aws-sdk-php v3，小文件（≤5MB）用putObject()并显式设ContentType，大文件（>5MB）须用upload()自动分片上传，且需配置CORS支持前端播放。

怎么用php将音频上传到s3

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() 方法会自动切片、并发上传、断点续传：

$result = $s3->upload(
    'your-audio-bucket',
    'uploads/large-' . $audioName,
    fopen($audioPath, 'r'),
    'public-read',
    [
        'params' => ['ContentType' => $contentType],
        'concurrency' => 3, // 并发数，别设太高（EC2小实例易OOM）
    ]
);

关键点：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

它底层调用 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"] } ]

漏掉CORS，浏览器控制台会报 No 'Access-Control-Allow-Origin' header，但S3上传本身是成功的——这个错误不发生在PHP侧，很容易误判为上传失败。