PHP的move_uploaded_file()函数本地正常线上执行失败是什么原因？

问题常见诱因（按出现概率从高到低排序） #

• 目录权限不足
  线上Linux服务器中，Web服务运行用户（常见为www-data、apache、nginx）对../assets/uploads/目标目录没有写入权限，本地开发环境（如Windows、集成开发包）通常权限限制宽松不会触发该问题。同时需确认线上环境是否真实创建了assets/uploads目录，部署时很容易遗漏空目录的上传。
• 相对路径匹配错误
  线上站点的目录结构可能和本地不一致，使用../拼接的相对路径无法正确定位到目标上传目录。建议替换为绝对路径拼接，示例：

  $path = $_SERVER['DOCUMENT_ROOT'] . '/assets/uploads/' . basename($_FILES['file']['name']);
  

  可在代码中临时打印$path的实际值，确认路径是否符合预期。
• PHP配置限制
  线上php.ini的配置可能限制了上传能力，需检查以下参数：
  • file_uploads 是否为On，是否开启文件上传功能
  • upload_max_filesize 是否小于上传的图片大小
  • post_max_size 是否小于本次POST请求的总数据大小
  • upload_tmp_dir 临时目录是否存在、是否有写入权限
    可在代码中先打印$_FILES['file']['error']的返回值，对照PHP官方上传错误码定位具体配置问题：如果返回1代表超出upload_max_filesize限制，返回2代表超出表单MAX_FILE_SIZE限制，返回6代表找不到临时目录。
• SELinux权限限制
  若线上服务器开启了SELinux，即使目录权限设置为777，Web服务默认也没有目录写入权限，需执行命令放行Web服务的写入权限：

  setsebool -P httpd_unified 1
  

• 文件名编码问题
  若上传的文件名包含中文、特殊字符，线上服务器的系统编码和本地不一致，会导致move_uploaded_file识别路径失败。建议上传时将文件名替换为随机生成的英文+数字串，同时也能避免同名文件覆盖的问题。

额外注意事项 #

现有代码存在SQL注入风险，直接将未过滤的$_POST['pid']、文件名参数拼接进SQL语句，上线前需要做参数转义或者改用预处理语句。前端的文件名后缀校验不可靠，服务端需要额外校验文件的真实类型，避免恶意文件上传。

内容的提问来源于stack exchange，提问作者Soumya Darshan Padhy