上传成功后必须立即用file_put_contents()写入日志，包含时间、截断文件名、大小、类型、哈希IP；失败时须记录具体错误码及配置值，并脱敏路径、UA、手机号等敏感信息。
上传成功后立即写入日志文件
PHP 处理音频上传时，$_FILES 中的临时文件路径只在脚本生命周期内有效，必须在 move_uploaded_file() 成功后立刻记录日志，否则后续无法获取原始文件名、大小、类型等关键信息。
常见错误是把日志逻辑放在文件校验失败分支里，或误以为能等异步任务再记录——实际上传完成即刻就要落盘。
-
file_put_contents()最简单，用FILE_APPEND | LOCK_EX避免并发写乱序 - 日志内容至少包含：
date('c')、$_FILES['audio']['name']、$_FILES['audio']['size']、$_FILES['audio']['type']、$_SERVER['REMOTE_ADDR'] - 不要直接拼接
$_FILES['audio']['name']到日志字符串中，先用mb_substr($name, 0, 100)截断，防超长文件名撑爆单行
用 error_log() 写日志要注意路径和权限
调用 error_log() 写自定义日志时，如果传入文件路径（如 error_log($msg, 3, '/var/log/php-audio-upload.log')），PHP 必须对目标目录有写权限，且 Web 服务器用户（如 www-data 或 nginx）需能创建/追加该文件。
容易踩的坑：本地开发时路径写成 C:\logs\...，上线后因路径不存在静默失败；或日志目录权限为 755 但属主不是 Web 用户，导致写入失败且无报错提示。
立即学习“PHP免费学习笔记（深入）”；
- 上线前用
is_writable(dirname($log_path))显式检查 - 避免硬编码绝对路径，改用
__DIR__ . '/logs/audio-upload.log'并确保该目录存在且可写 - 若用
error_log($msg, 4)发送到系统 syslog，需确认 PHP 配置中error_log = syslog已启用
记录失败原因比只记“上传失败”有用得多
音频上传失败常由多种原因引起：UPLOAD_ERR_INI_SIZE（upload_max_filesize 限制）、UPLOAD_ERR_FORM_SIZE（表单 MAX_FILE_SIZE 限制）、UPLOAD_ERR_NO_TMP_DIR（临时目录丢失）等。只记 “failed” 对排查毫无帮助。
必须把 $_FILES['audio']['error'] 的具体值和对应解释一并写入日志，同时补充 ini_get('upload_max_filesize') 和 ini_get('post_max_size') 当前值，方便快速定位配置瓶颈。
- 用数组映射错误码：
[UPLOAD_ERR_OK => 'ok', UPLOAD_ERR_INI_SIZE => 'ini_size']，避免硬编码字符串 - 对
UPLOAD_ERR_NO_FILE，额外检查$_POST是否为空，排除前端未提交表单的可能 - 音频格式校验（如用
finfo_file()）失败也应记入同一日志行，并标注mime_check: failed
避免日志中暴露敏感路径或用户标识
音频上传日志常被运维或安全团队定期扫描，若混入绝对路径（如 /home/deploy/app/uploads/...）或用户唯一 ID（如数据库主键），可能成为信息泄露入口。
真实场景中，攻击者可通过日志路径推测部署结构，或通过高频上传日志反推用户行为模式。必须做最小化脱敏。
- 过滤掉
$_SERVER['HTTP_REFERER']和$_SERVER['HTTP_USER_AGENT']中的 URL 参数和版本号（如截取Chrome/124而非完整 UA 字符串） - 用哈希代替原始 IP：
hash_hmac('sha256', $_SERVER['REMOTE_ADDR'], $secret_key)，既保留可聚合性又不暴露真实地址 - 音频文件名若含用户昵称或手机号，先用
preg_replace('/\d{3,}/', '***', $name)替换数字段
