MacBook M1芯片下PHP使用move_uploaded_file()无法上传图片至指定文件夹

一、先加错误排查代码，精准定位问题 #

你的代码里没对move_uploaded_file的返回值做校验，先补上这段调试代码，直接拿到具体错误原因：

// 执行move_uploaded_file后立即添加
if (!move_uploaded_file($_FILES['image']['tmp_name'], $target_file)) {
    // 调试用，线上环境要删掉
    error_log("上传失败详情：" . print_r(error_get_last(), true));
    die("文件上传失败，请查看服务器日志");
}

通过日志能直接知道是权限问题、路径不存在还是其他错误，比瞎猜高效多了。

二、重点排查文件夹权限（M1环境核心问题） #

M1 Mac上，Web服务（Apache、Nginx、PHP-FPM）默认运行用户是_www，如果你的目标文件夹在个人用户目录下（比如/Users/你的用户名/Documents/upload/），_www大概率没有读写权限。

解决步骤：

1. 打开终端，替换成你的目标文件夹路径执行：

# 给_www用户赋予文件夹所有权
sudo chown -R _www:_www /Users/你的用户名/目标文件夹路径
# 设置读写权限
sudo chmod -R 755 /Users/你的用户名/目标文件夹路径

2. 如果用的是MAMP/XAMPP这类集成环境，运行用户可能是daemon，把上面的_www换成daemon即可。

三、确认目标路径的有效性 #

别迷信“完整路径”，可能存在大小写错误或者路径不存在的情况：

• MacOS系统大小写不敏感，但PHP文件函数是区分大小写的，比如Uploads和uploads是两个不同路径；
• 提前检查路径是否存在，不存在就递归创建：

$target_dir = "/Users/你的用户名/目标文件夹/";
if (!file_exists($target_dir)) {
    // 0755是权限，true表示自动创建父文件夹
    mkdir($target_dir, 0755, true);
}
// 验证路径是否有效
var_dump(realpath($target_dir));

如果输出false，说明路径有问题，先解决这个。

四、检查PHP上传配置限制 #

虽然你说图片已经存入数据库，但还是要确认PHP配置没卡脖子：
找到php.ini文件，修改以下参数（根据你的需求调整大小）：

upload_max_filesize = 10M
post_max_size = 12M

修改后必须重启Web服务（Apache/Nginx/PHP-FPM）才会生效。

五、验证临时文件合法性 #

确保上传的临时文件是有效的：

if (!is_uploaded_file($_FILES['image']['tmp_name'])) {
    die("非法上传文件，请通过表单提交");
}

避免因为临时文件丢失或者非HTTP POST上传导致的失败。

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