PHP音频上传失败需先查$_FILES'audio'值定位根源：0表示成功但后续处理出错；1或2为大小限制问题；4是前端未传文件；6或7系临时目录不可写或权限不足；再确认enctype、name匹配及php.ini中upload_max_filesize、post_max_size等配置已生效并重启服务。
PHP接收音频上传失败，绝大多数情况不是代码写错了，而是环境配置或权限卡在了某一层。先看$_FILES里的error值，它直接告诉你问题在哪一层——别跳过这步。
查$_FILES['audio']['error']返回值定位根源
音频上传失败时，$_FILES数组的error字段是第一手线索，不同值对应完全不同的解决路径：
-
0：上传成功，问题出在后续处理（如FFmpeg执行、文件移动） -
1或2：PHP或表单限制了大小，比如上传一个25MB的MP3却卡在upload_max_filesize = 2M -
4：前端根本没传文件——常见于React中FormData.append()漏掉audio字段，或input没设name="audio" -
6：PHP找不到临时目录，upload_tmp_dir配置为空或路径不可写 -
7：临时文件写入失败，通常是/tmp满或SELinux/ACL阻止了web用户写入
确认enctype和name是否严格匹配
音频上传对表单结构极其敏感，错一个字符就收不到$_FILES：
- HTML
<form></form>必须带enctype="multipart/form-data"，缺了这个，$_FILES永远是空数组 -
<input type="file" name="audio">中的name必须和PHP里读取的键名完全一致，区分大小写，不能是audioFile或Audio - 如果用
multiple，$_FILES['audio']会变成二维数组，需遍历$_FILES['audio']['name'][0]等，直接读$_FILES['audio']['name']会报错 - React中用
FormData手动构造时，确保append的是event.target.files[0]，不是event.target.value
检查php.ini三项关键配置是否生效
音频文件普遍比图片大，upload_max_filesize和post_max_size很容易成为瓶颈，且修改后不重启服务不会生效：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -i | grep -E "(file_uploads|upload_max_filesize|post_max_size)"确认当前值，别只改了配置文件却忘了sudo systemctl restart apache2或sudo service php-fpm restart -
post_max_size必须大于upload_max_filesize，例如设upload_max_filesize = 50M，则post_max_size = 55M，否则即使文件没超限也会被截断 - 若用Nginx，还需同步检查
client_max_body_size，它优先级高于PHP配置；Apache则看LimitRequestBody -
max_execution_time建议调到300以上，大音频上传+处理容易超时
验证目标目录和临时目录的权限链
权限问题在音频上传里高频出现，因为涉及两个写入点：PHP临时目录（tmp_name）和你指定的保存目录（move_uploaded_file()目标）：
- 用
ls -ld /var/www/html/uploaded/确认该目录属主是www-data:www-data（Ubuntu/Apache）或nginx:nginx（CentOS/Nginx），不是root - 临时目录默认是系统
/tmp，但有些环境会自定义upload_tmp_dir，用phpinfo()查准路径，再ls -ld看权限 - 测试写入：用
sudo -u www-data touch /var/www/html/uploaded/test.txt，如果报Permission denied，说明权限没给对 - 避免
chmod -R 777，生产环境应chown -R www-data:www-data uploaded/+chmod -R 755 uploaded/
音频上传失败的坑，往往藏在error码、enctype拼写、php.ini重启、以及www-data对两个目录（临时+目标）的写权限这四层里。漏掉任意一层，都会让你在日志里反复看到空$_FILES或move_uploaded_file(): Unable to move。调试时别猜，先打var_dump($_FILES)，再顺藤摸瓜。
