原生PHP文件上传测试：Postman请求后$_FILES数组为空，求排查方向

已确认php.ini中file_uploads=on、upload_max_filesize和post_max_size配置正常，Postman测试时仍出现$_FILES为空，可从以下几个方向排查：

• Postman请求配置错误

  1. 确保请求方式为POST，Body选择form-data类型，而非raw、x-www-form-urlencoded等。
  2. 文件字段的类型需设置为File（而非默认的Text），且字段Key无拼写错误，同时确认已选中本地文件再发送请求。
  3. 检查请求头的Content-Type，需为multipart/form-data; boundary=xxx格式（Postman选form-data会自动生成，若手动修改过需恢复）。

• PHP代码输出误导
  当前代码直接echo $_FILES[$value]，但$_FILES的每个元素是关联数组，直接echo会输出Array，容易误以为为空。建议替换为var_dump($_FILES)或print_r($_FILES)，查看真实的文件上传数据结构。

• 临时目录权限问题
  检查PHP配置中的upload_tmp_dir：

  1. 确认该目录存在，若未配置则使用系统默认临时目录。
  2. 确保PHP进程对该目录拥有读写权限，权限不足会导致文件无法写入临时目录，进而$_FILES为空。可通过phpinfo()查看当前upload_tmp_dir的设置。

• 服务器安全模块拦截
  部分服务器的安全模块（如mod_security）可能拦截文件上传请求，可查看服务器错误日志（Apache的error.log、Nginx的error.log等），排查是否有相关拦截记录。

• PHP运行模式问题
  若PHP以CGI模式运行，部分环境下可能存在文件上传的配置差异，可通过phpinfo()查看当前运行的SAPI（如FPM、CGI、CLI等），确认是否有对应模式下的特殊配置限制。

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