PHP上传音频文件到OSS前须确认SDK已安装（composer require aliyuncs/oss-sdk-php）并正确初始化，Endpoint必须HTTPS、AK需PutObject权限、Bucket名不能含点号；音频宜用putObject而非uploadFile，需校验$_FILES'audio'、设正确Content-Type（如audio/mpeg）、捕获OssException排查错误。
PHP上传音频文件到OSS前，必须确认OSS SDK已正确安装并初始化
不装SDK或初始化失败，putObject 会直接报错 Class 'OSSOssClient' not found 或 InvalidEndpoint。用 Composer 安装官方 SDK：
composer require aliyuncs/oss-sdk-php。初始化时注意三点：Endpoint 必须是 HTTPS 协议（如
https://oss-cn-hangzhou.aliyuncs.com），AccessKey ID 和 Secret 必须有 PutObject 权限，Bucket 名称不能带点号（my-bucket.audio 是非法的，应为 my-bucket-audio）。
上传音频文件要用 putObject，不是 uploadFile
uploadFile 是分片上传接口，适合大文件（>100MB），但音频通常小（MP3/WAV/FLAC 多在几 MB 内），用 putObject 更简单、更可控。常见错误是把 $_FILES['audio']['tmp_name'] 直接传给 putObject 的第二个参数（$object），其实那是本地路径，putObject 的第二个参数是 OSS 上的 Object Key（比如 audio/2024/1025/record.mp3），第三个参数才是文件路径或资源流：
$ossClient->putObject($bucket, 'audio/2024/1025/record.mp3', $_FILES['audio']['tmp_name']);
- 如果想从内存流上传（比如先校验格式再传），可用
fopen($_FILES['audio']['tmp_name'], 'rb')得到 resource，传给第三个参数 - 务必检查
$_FILES['audio']['error'] === UPLOAD_ERR_OK，否则可能上传空内容 - OSS 不校验音频格式，传个 .txt 改名成 .mp3 也能成功 —— 校验得自己做（比如用
finfo_file）
音频上传后要设 Content-Type，否则网页播放可能失败
OSS 默认对未知扩展名返回 Content-Type: application/octet-stream，浏览器无法识别为音频，<audio> 标签会显示“无法加载”。必须显式设置 ContentType 参数：
$options = [
'contentType' => 'audio/mpeg', // MP3
// 'contentType' => 'audio/wav',
// 'contentType' => 'audio/flac',
];
$ossClient->putObject($bucket, $objectKey, $filePath, $options);- MP3 用
audio/mpeg，不是audio/mp3（后者非标准 MIME） - 可通过
pathinfo($_FILES['audio']['name'], PATHINFO_EXTENSION)动态匹配 MIME 类型 - 若前端需直链播放，还建议加
'CacheControl' => 'max-age=31536000'减少重复请求
上传失败时，putObject 抛出的异常信息比 HTTP 状态码更有用
别只看 curl_exec 返回 false 就认为失败 —— OSS SDK 全部封装成 OSSCoreOssException。捕获后打印 $e->getErrorMessage() 和 $e->getErrorCode() 才能准确定位：
立即学习“PHP免费学习笔记（深入）”；
try {
$ossClient->putObject(...);
} catch (OssException $e) {
error_log('OSS upload failed: ' . $e->getErrorCode() . ' - ' . $e->getErrorMessage());
// 常见：NoSuchBucket（Bucket 不存在）、AccessDenied（权限不足）、InvalidObjectName（Object Key 含非法字符如 或控制符）
}-
InvalidObjectName容易被忽略：Object Key 里不能有\，中文名需 UTF-8 编码且不超 1023 字节 - 网络超时默认是 5 秒，大音频建议调高：
$ossClient = new OssClient(..., ..., ..., ['timeout' => 30]) - 上传完成后记得
unlink($_FILES['audio']['tmp_name'])，不然 tmp 目录会堆积
OSS 本身不处理音频转码或元数据提取，上传只是第一步；后续播放、鉴权、防盗链都得靠额外配置或服务。
