PHP文件上传_PHP实现文件上传功能教程

上传失败时$_FILES为空或Error=4，需检查表单enctype、php.ini文件上传配置及字段名一致性；move_uploaded_file()失败主因是权限、路径或open_basedir限制；安全命名须校验扩展名白名单并用随机字符串重命名。

上传失败时 $_FILES 为空或 error 值为 4 怎么办

这通常不是 PHP 代码问题，而是表单或服务器配置没到位。先确认三点：

• 
  

  必须带 enctype="multipart/form-data"，缺了就根本不会传文件

• php.ini 中 file_uploads = On，且 upload_max_filesize 和 post_max_size 要足够大（比如都设为 20M）
• 上传字段名要和 $_FILES 中的键一致，比如 对应 $_FILES['avatar']

检查 $_FILES['xxx']['error'] 的值：4 表示没有文件被选中，1 或 2 是超限，6 是找不到临时目录 —— 这时候要查 upload_tmp_dir 是否可写。

move_uploaded_file() 返回 false 的常见原因

函数失败不等于文件没上传，它只负责把临时文件挪到目标位置。失败往往卡在权限、路径或安全限制上：

• 目标目录必须存在，且 Web 服务器用户（如 www-data 或 apache）有写权限
• 路径不能是相对路径（如 "uploads/"），建议用 __DIR__ . '/uploads/' . $filename
• 如果启用了 open_basedir，目标路径必须落在允许范围内
• windows 下注意反斜杠转义问题，统一用 / 或 DIRECTORY_SEPARATOR

if (move_uploaded_file($_FILES['file']['tmp_name'], __DIR__ . '/uploads/' . $safe_name)) {     echo '上传成功'; } else {     error_log('move_uploaded_file failed: ' . print_r($_FILES['file'], true)); }

如何安全地生成保存文件名

绝不能直接用 $_FILES['xxx']['name']，它可能含路径、特殊字符甚至恶意扩展名（如 shell.php.jpg）。关键步骤是：

立即学习“PHP免费学习笔记（深入）”；

• 用 pathinfo() 提取原始扩展名，再白名单校验（如只允许 ['jpg', 'png', 'pdf']）
• 用 uniqid() . bin2hex(random_bytes(8)) 生成随机前缀，避免重名和猜测
• 强制小写扩展名，防止大小写绕过（如 .PHP）
• 不要保留原始文件名中的中文或空格，它们在某些系统下会出问题

$ext = strtolower(pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION)); $allowed = ['jpg', 'jpeg', 'png', 'pdf']; if (!in_array($ext, $allowed)) {     die('不支持的文件类型'); } $safe_name = uniqid() . '_' . bin2hex(random_bytes(8)) . '.' . $ext;

为什么上传大文件时页面直接 500 或空白

这不是 PHP 报错，而是 nginx / Apache 在请求体到达 PHP 前就拦截了。重点查 Web 服务器配置：

• Nginx：检查 client_max_body_size（单位是 10M 这种），需 ≥ php.ini 中的 post_max_size
• Apache：确认 LimitRequestBody 没设成 0 或过小值
• 如果用云 WAF（如 Cloudflare），它也有默认 100MB 上传限制，需单独调整
• 超时也要同步调大：fastcgi_read_timeout（Nginx）或 Timeout（Apache）

调试时打开 error_log 并设为 error_reporting(E_ALL)，否则静默失败很难定位。