PHP文件上传失败需先查$_FILES为空或error非0；常见原因包括表单缺enctype、配置超限、临时目录不可写等；move_uploaded_file()须校验is_uploaded_file且禁用用户文件名；上传类应仅传存储路径、类型白名单、大小阈值。
PHP 文件上传失败常见报错怎么快速定位
上传失败时先别急着改代码，$_FILES 数组为空或 error 值非 0，基本就锁定了方向。最常踩的坑是表单没写 enctype="multipart/form-data"，或者 PHP 配置限制了大小。
-
error = 1或2：说明超出了upload_max_filesize或MAX_FILE_SIZE隐藏字段值，优先查phpinfo()里的这两个配置 -
error = 3：文件只上传了部分，通常是网络中断或 Nginx 的client_max_body_size比 PHP 限制还小 -
error = 6或7：临时目录丢失或不可写，检查sys_get_temp_dir()返回路径的权限和磁盘空间
用 move_uploaded_file() 安全移动文件要注意什么
这是唯一推荐的上传后处理函数，它会校验文件是否真来自 $_FILES，防止 LFI 或路径遍历攻击。但很多人直接拼接用户传来的 $_FILES['file']['name']，这就埋了雷。
- 永远不要信任
$_FILES['file']['name']，它可被伪造；用pathinfo($tmp_name, PATHINFO_EXTENSION)提取扩展名更可靠 - 目标路径必须是绝对路径，且不能包含用户输入的目录名；建议用
__DIR__ . '/uploads/' . uniqid() . '.' . $ext - 上传前务必调用
is_uploaded_file($tmp_name)，否则可能绕过校验（尤其在某些 SAPI 下）
面向对象封装上传类时，哪些参数必须作为构造参数传入
硬编码路径、类型白名单、大小限制会让类失去复用性。真正需要外部控制的只有三类东西：存储位置、允许类型、尺寸阈值。其他都该内置默认逻辑。
- 必须传：
$uploadDir（绝对路径）、$allowedTypes（如['image/jpeg', 'image/png']）、$maxSize（字节数） - 不建议传：
$fileName或$subDir—— 这些应该由类内部根据时间戳/哈希生成，避免冲突和覆盖 - 错误信息不该抛异常，而应统一返回关联数组，含
success、message、file_path字段，方便 API 层直接 JSON 输出
为什么不要在上传类里做图片缩放或格式转换
职责分离不是教条，是为避免耦合导致调试困难。上传阶段只管“把文件安全存到磁盘”，后续处理（比如生成缩略图、转 WebP）应该交给独立的服务或队列任务。
立即学习“PHP免费学习笔记（深入）”；
- GD 或 Imagick 扩展缺失会导致整个上传流程崩溃，而上传本身是基础能力，不该依赖可选组件
- 大图处理耗内存，同步执行容易超时，
set_time_limit(0)不是解法，是掩盖设计缺陷 - 如果真要集成，至少用接口隔离，比如传入一个实现
ImageProcessor接口的对象，而不是在上传类里写imagecreatefromjpeg()
上传看似简单，但路径拼接、类型校验、临时文件清理、并发写入这几个点，随便漏一个就会在线上出 silent fail。尤其是多服务器部署时，move_uploaded_file() 对 NFS 挂载目录的支持很弱，这点文档几乎不提，但实际踩过的人才知道有多痛。
