move_uploaded_file 返回 false 主因是临时文件路径无效、目标目录权限不足或 open_basedir 限制；需检查 $_FILES'file' 是否存在、目标路径是否绝对且父目录可写、upload_tmp_dir 是否在 open_basedir 范围内。
绝大多数情况下，move_uploaded_file 返回 false 不是因为代码写错了，而是因为临时文件路径无效或目标目录权限不足。
检查 $_FILES['xxx']['tmp_name'] 是否真实存在
PHP 上传流程中，文件先被存到系统临时目录（如 /tmp），再由 move_uploaded_file 移动。如果这个临时路径压根不存在，函数直接返回 false，且不报错——只靠 var_dump 或日志才能发现。
- 必须用
file_exists($_FILES['file']['tmp_name'])显式验证，不能只看$_FILES['file']['error'] === UPLOAD_ERR_OK - 常见陷阱：表单没加
enctype="multipart/form-data"，或用了GET提交，此时$_FILES为空，tmp_name是空字符串或未定义 - 某些容器或云环境（如 Docker、Cloudflare Pages）会禁用默认临时目录，需手动设
upload_tmp_dir并确保其可写
确认目标路径是绝对路径且父目录可写
move_uploaded_file 对相对路径极其敏感。比如写成 "uploads/test.jpg"，实际解析路径取决于当前脚本所在位置，极易出错；而权限问题几乎都发生在目标目录的 write 权限上，不是文件本身。
- 优先使用
__DIR__ . '/uploads/' . basename($filename)构造绝对路径，避免歧义 - 用
is_writable(dirname($destination))检查父目录是否可写，而不是只查文件是否存在 - Linux 下运行
ls -ld uploads/，确认 Web 用户（如www-data）有w权限；若显示drwxr-xr-x，说明组和其他用户不可写，需chmod 775 uploads/或chown www-data:yourgroup uploads/ - 注意：即使目录权限正确，父级路径中任一环节（如
/var/www/html/uploads）缺少执行（x）权限，也会导致“failed to open stream”
别忽略 open_basedir 和 upload_tmp_dir 的隐性限制
这两个配置项不会让 move_uploaded_file 报明确错误，但会让整个上传链在静默中失败。
立即学习“PHP免费学习笔记（深入）”；
- 若启用了
open_basedir，则upload_tmp_dir必须落在该限制范围内，否则临时文件根本无法生成，tmp_name为空或非法 - 用
ini_get('open_basedir')和ini_get('upload_tmp_dir')打印确认，不要依赖 php.ini 注释或默认值 - 某些共享主机强制设置
open_basedir，此时只能把上传目标也挪进允许路径内，例如/home/user/tmp_uploads/ -
move_uploaded_file创建的文件权限固定为0600（仅属主可读写），无法通过umask()修改；如需其他用户（如 CLI 账户）后续处理，得用copy()+unlink()替代，或改用chmod()补充赋权
真正卡住人的地方，往往不是 move_uploaded_file 本身，而是它依赖的那几层路径和权限状态——临时文件是否落地、目标目录是否可写、open_basedir 是否拦路，三者缺一不可。每次返回 false，按这三点挨个 var_dump 和 ls -ld，基本就能定位。
