PHP move_uploaded_file()无报错却失效，请求技术排查解决

这种毫无征兆的失效确实让人头疼，尤其是代码没动过的情况。结合你说的「目录能创建但文件传不上去、还误报成功」的现象，我给你列几个最可能的排查方向：

1. 目标目录的写入权限问题（最常见） #

虽然你能成功创建目录，但目录的写入权限未必对PHP运行用户开放。比如Apache/Nginx通常是以www-data、apache或nginx用户运行的，如果这个用户没有目标目录的写入权限，move_uploaded_file会静默失败。

• 排查小技巧：
  • Linux服务器用命令ls -l /path/to/your/dir查看目录权限；
  • 在代码里加一行var_dump(is_writable($target_dir));，如果返回false就是权限问题；
• 解决办法：
  • Linux下执行chmod 755 /path/to/your/dir（开放读写执行权限），或者chown www-data:www-data /path/to/your/dir（把目录所有者改成PHP运行用户）；
  • Windows服务器要确保IIS或PHP运行用户有该目录的写入权限。

2. PHP配置参数被偷偷改动 #

可能运维人员或者服务器自动更新时修改了php.ini的关键参数：

• 检查这几个核心参数：
  • file_uploads：如果被设为Off，直接禁用了文件上传功能；
  • upload_max_filesize/post_max_size：如果值被调得太小，超过限制的文件会被静默丢弃；
  • open_basedir：如果目标目录不在这个参数指定的允许范围内，PHP会拒绝访问；
• 排查小技巧：在代码里加phpinfo();，输出后搜索这些参数的当前值；
• 解决办法：把参数改回合理值，比如file_uploads = On，upload_max_filesize = 10M，并确保目标目录在open_basedir的允许列表里。

3. PHP临时上传目录出问题 #

PHP上传文件时会先把文件存到临时目录（由upload_tmp_dir指定），如果这个目录没权限或者磁盘满了，文件根本没法从临时目录移动到目标目录。

• 排查小技巧：
  • 用phpinfo()找到upload_tmp_dir的路径，检查该目录的权限和磁盘剩余空间；
  • 打印$_FILES['your_file']['error']，如果返回UPLOAD_ERR_NO_TMP_DIR（临时目录不存在）或UPLOAD_ERR_CANT_WRITE（无法写入临时文件），就是这个问题；
• 解决办法：给临时目录加写入权限，清理磁盘空间，或者修改upload_tmp_dir到一个可用的目录。

4. 代码里的错误处理完全缺失 #

你说会显示「上传成功」，大概率是代码没检查move_uploaded_file的返回值，也没处理$_FILES里的错误信息。比如这种错误写法：

// 错误示例：不管成功失败都输出成功
move_uploaded_file($_FILES['file']['tmp_name'], $target_path);
echo "上传成功";

• 修复后的代码（一定要加错误检查）：

// 先检查上传有没有报错
if ($_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    echo "上传错误代码：" . $_FILES['file']['error'];
    exit;
}
// 再检查文件移动是否成功
$target_path = $target_dir . basename($_FILES['file']['name']);
if (move_uploaded_file($_FILES['file']['tmp_name'], $target_path)) {
    echo "上传成功";
} else {
    echo "文件移动失败，目标路径：" . $target_path;
}

加上这段后，你就能看到真正的错误原因，不会再被误报信息误导。

5. 服务器安全软件拦截 #

比如ModSecurity、云WAF这类安全工具，可能误把你的上传文件判定为恶意内容，直接拦截了上传操作。

• 排查小技巧：查看服务器的安全日志（比如ModSecurity日志在/var/log/apache2/modsec_audit.log），找有没有和文件上传相关的拦截记录；
• 解决办法：调整安全规则，把你的上传路径、合法文件类型加入白名单。

内容的提问来源于stack exchange，提问作者WolfieeifloW