PHP多文件上传需正确配置HTML表单（含multiple和files[]）、调整php.ini中max_file_uploads等参数、遍历$_FILES数组逐个处理、为每个文件单独调用move_uploaded_file并生成唯一文件名，最后可封装为UploadHandler类提升复用性。
如果您在PHP项目中需要让用户一次性上传多个文件，但发现只有单个文件被接收或上传失败，则可能是由于HTML表单设置、PHP配置或后端处理逻辑不正确。以下是实现PHP多文件同时上传功能的具体步骤：
一、配置HTML表单支持多文件选择
前端表单必须明确启用多文件选择功能，并使用正确的input类型与属性，确保浏览器能将多个文件作为数组提交至服务器。
1、在HTML中创建form标签，method属性设为POST，enctype属性必须设置为multipart/form-data。
2、添加type为file的input元素，并在其上添加multiple属性以允许选择多个文件。
立即学习“PHP免费学习笔记（深入）”；
3、为该input设置name属性，且其值需以方括号结尾（如files[]），以便PHP将其识别为数组。
4、可选：添加accept属性限制文件类型，例如accept="image/*"。
二、调整PHP服务器配置参数
PHP默认对上传文件的数量和大小有限制，需修改php.ini中的相关配置项，否则超出限制的文件将无法被接收或导致$_FILES为空。
1、将max_file_uploads设置为大于等于预期同时上传的文件数量（如20）。
2、确保upload_max_filesize和post_max_size足够大，且后者应大于前者与所有文件总和的预估大小。
3、确认file_uploads值为On，否则整个上传功能被禁用。
4、修改完成后重启Web服务器（如Apache或Nginx）使配置生效。
三、服务端解析$_FILES多维数组结构
当用户选择多个文件提交后，PHP将生成一个嵌套数组形式的$_FILES变量，其键名对应HTML中input的name值，内部包含name、tmp_name、error、size、type五个子数组，需按索引逐层遍历提取信息。
1、检查$_FILES中目标字段是否存在且不为空，例如isset($_FILES['files'])。
2、验证$_FILES['files']['error']数组中每个元素是否为0（UPLOAD_ERR_OK），排除上传错误项。
3、使用for循环或foreach遍历文件索引，从$_FILES['files']['name'][$i]、$_FILES['files']['tmp_name'][$i]等路径获取各文件元数据。
4、对每个文件单独执行移动操作，调用move_uploaded_file()函数将其从临时目录移至指定存储路径。
四、使用move_uploaded_file批量处理文件
PHP不支持直接对$_FILES数组整体调用move_uploaded_file，必须对每个文件独立调用该函数，并配合唯一文件名生成策略防止覆盖。
1、为每个上传文件生成安全的唯一文件名，例如结合date('YmdHis')、uniqid()与原扩展名拼接。
2、构建完整的目标保存路径，确保目录存在且具有写入权限，必要时使用mkdir()递归创建。
3、调用move_uploaded_file($_FILES['files']['tmp_name'][$i], $targetPath)执行单个文件转移。
4、每次调用后检查返回值是否为true，若失败则记录$_FILES['files']['error'][$i]对应错误码用于调试。
五、通过自定义类封装多文件上传逻辑
为提升代码复用性与可维护性，可将上述流程封装为独立类，提供配置化参数与错误回调机制，避免重复编写校验与移动逻辑。
1、定义UploadHandler类，构造函数接收目标目录、允许类型、最大单文件尺寸等参数。
2、实现validateFiles()方法，统一检查error码、size、type，并返回有效文件索引列表。
3、实现saveAll()方法，遍历有效索引，调用内部saveOne()完成单文件保存并返回结果数组。
4、在saveOne()中集成文件重命名、路径创建、move_uploaded_file及异常捕获逻辑。
