首先检查$_FILES’video’值,0为成功,1-8对应不同错误并返回明确提示;再用finfo_file()校验MIME类型及扩展名白名单;调整php配置应对大文件,设置超时与内存限制;确保上传目录权限安全且路径正确,使用唯一文件名避免覆盖;失败时记录日志并友好提示。

视频上传在PHP应用中很常见,但容易因文件大小、格式、服务器配置等问题失败。一套完善的错误处理机制能提升用户体验和系统稳定性。核心是捕获上传过程中的各类异常,并给出明确反馈。
检查上传是否成功
PHP通过$_FILES数组提供上传信息,其中Error字段是判断关键。任何上传操作都应先检查该值:
- UPLOAD_ERR_OK (0):上传成功,可继续处理
- UPLOAD_ERR_INI_SIZE (1):文件超过php.ini中upload_max_filesize限制
- UPLOAD_ERR_FORM_SIZE (2):文件超过表单MAX_FILE_SIZE限制
- UPLOAD_ERR_PARTIAL (3):文件仅部分上传
- UPLOAD_ERR_NO_FILE (4):未选择文件
- UPLOAD_ERR_NO_TMP_DIR (6):缺少临时目录
- UPLOAD_ERR_CANT_WRITE (7):写入磁盘失败
- UPLOAD_ERR_EXTENSION (8):php扩展中断上传
代码中应使用switch或if逐一判断这些错误码,返回对应提示。
验证文件类型与扩展名
仅靠前端验证不安全,PHP需再次确认文件类型。推荐结合MIME类型和扩展名双重校验:
立即学习“PHP免费学习笔记(深入)”;
- 使用finfo_file()获取真实MIME类型,避免伪造
- 允许的类型如video/mp4、video/avi、video/mov等
- 检查文件扩展名是否在白名单内,防止.php伪装
若类型不符,应记录日志并返回“不支持的视频格式”提示,不保存文件。
处理大文件与超时问题
上传大视频常因超时或内存不足失败。需调整PHP配置并优化脚本:
- 增大upload_max_filesize和post_max_size
- 设置max_execution_time和max_input_time为更高值
- 使用分片上传或断点续传方案减轻压力
- 上传后异步处理转码,避免请求阻塞
当检测到超时或内存错误,提示用户“文件过大或网络不稳定,请稍后重试”。
权限与路径安全
确保目标目录有写权限,且不在Web根目录下直接暴露:
- 设置上传目录权限为755或775,属主正确
- 将视频存放在web目录外,通过脚本控制访问
- 生成唯一文件名防止覆盖,如uniqid() . ‘.mp4’
- 上传失败时记录错误日志,便于排查
若move_uploaded_file()失败,可能是权限或路径问题,需检查服务器配置。
基本上就这些。一个健壮的视频上传流程离不开细致的错误捕捉和用户友好的反馈。关键是把PHP的原生机制用好,别忽略每个error码的意义。


