php文件上传必须使用post方法并设置enctype="multipart/form-data"，get/put/patch均不支持；常见失败原因包括php.ini配置限制、web服务器体大小限制及表单name缺失。
PHP文件上传必须用 POST 方法
GET 方法完全不支持文件上传，因为 URL 长度限制、编码问题和服务器默认拒绝等多重原因，$_FILES 数组在 GET 请求下始终为空。PHP 的文件上传机制依赖于 multipart/form-data 编码格式，而该格式只能在 POST 请求中正确提交。
form 表单的 method 和 enctype 缺一不可
仅写 method="post" 不够，必须同时设置 enctype="multipart/form-data"，否则浏览器会以 application/x-www-form-urlencoded 方式编码，导致 $_FILES 为空且 $_POST 中只收到文件名（无二进制内容）。
<form action="upload.php" method="post" enctype="multipart/form-data"> <input type="file" name="avatar"> <button type="submit">上传</button> </form>
-
enctype错写成enctype="text/plain"或漏写，都会让上传静默失败 - 多个文件字段需确保
name值不同，或使用数组语法如name="photos[]" - 若用 AJAX 上传，
FormData对象自动处理编码，但 fetch / XMLHttpRequest 仍需显式设method: 'POST'
为什么不能用 PUT 或 PATCH 直传文件到 PHP？
PHP 默认不解析 PUT/PATCH 请求体中的 multipart/form-data，$_FILES 始终为空。虽然可通过读取 php://input 手动解析原始 body，但需自行处理边界符、编码、文件保存等，极易出错且失去 move_uploaded_file() 的安全校验（如是否为合法上传临时文件）。
- 框架（如 Laravel、Symfony）可能封装了 PUT 文件解析，但底层仍是将请求转为模拟 POST 处理
- 直接
file_get_contents('php://input')拿到的是原始二进制流，不含字段名、文件名、类型等元信息 - 生产环境建议坚持标准 POST +
multipart/form-data，避免自定义解析引入漏洞
常见上传失败却无报错的隐藏原因
即使用了 POST 和正确 enctype，上传仍可能“无声失败”：表单提交后 $_FILES 为空，$_POST 也为空，页面看似刷新但没提示——这往往不是代码问题，而是服务端配置拦截。
立即学习“PHP免费学习笔记（深入）”；
-
upload_max_filesize（php.ini）小于实际文件大小 →$_FILES全为空，error值为UPLOAD_ERR_INI_SIZE（值 1），但需主动检查$_FILES['field']['error'] -
post_max_size小于整个表单数据（含文件+其他字段）→ 整个$_POST和$_FILES被清空，且不报错 - Apache 的
LimitRequestBody或 Nginx 的client_max_body_size限制触发 → 请求被 Web 服务器直接拒收，PHP 根本收不到 - 表单中
<input type="file">没有name属性 → 该字段不会出现在$_FILES中
调试时务必先检查 var_dump($_FILES) 和 ini_get('upload_max_filesize')，再查 Web 服务器日志。
