如何基于ThinkPHP5.1编写文件上传接口-ThinkPHP-PHP中文网

thinkphp5.1文件上传接口需校验类型/大小、规范保存路径、防范安全风险。示例包含单文件上传、多文件批量处理、api兼容方案及生产级安全建议，如禁用脚本解析、服务端白名单校验等。

如何基于thinkphp5.1编写文件上传接口

ThinkPHP5.1 提供了简洁易用的文件上传支持，编写一个安全、健壮的文件上传接口，关键在于正确处理上传验证、路径配置、文件保存和错误反馈。下面以常见需求（单文件上传、限制类型/大小、自定义保存路径）为例，给出可直接落地的实现方式。

一、基础上传接口（支持表单提交）

在控制器中使用 $request->file() 获取上传文件对象，调用 move() 方法保存：

确保表单 enctype="multipart/form-data"
文件字段名需与 file() 参数一致（如 file）
推荐使用 validate 参数内置校验，避免手动判断

示例代码：

public function upload()
{
    $file = request()->file('file');
    if (empty($file)) {
        return json(['code' => 400, 'msg' => '未检测到上传文件']);
    }

    // 配置验证规则（后缀、大小）
    $info = $file->validate(['size'=>1024*1024*2,'ext'=>'jpg,png,gif,jpeg'])->move(ROOT_PATH . 'public' . DS . 'uploads');
    
    if ($info) {
        // 返回相对路径（便于前端访问），注意 DS 是目录分隔符
        $path = str_replace(ROOT_PATH . 'public' . DS, '', $info->getSaveName());
        return json(['code' => 200, 'msg' => '上传成功', 'data' => ['url' => '/uploads/' . $path]]);
    } else {
        return json(['code' => 400, 'msg' => $file->getError()]);
    }
}

二、支持多文件上传与自定义命名

多文件时，request()->file() 返回数组，需遍历处理；自定义文件名建议用 uniqid() + 时间戳 + 原扩展名 避免冲突：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

用 array_map() 统一批量处理更清晰
move() 第二个参数可传入自定义文件名（不含路径）
务必检查 $info 是否为 false，否则调用 getSaveName() 会报错

示例片段：

$files = request()->file('files'); // 表单字段名为 files[]
$result = [];
foreach ($files as $file) {
    $ext = $file->getExtension();
    $newName = uniqid('up_') . '_' . time() . '.' . $ext;
    $info = $file->validate(['size'=>1024*1024,'ext'=>'pdf,doc,docx,xls,xlsx'])->move(ROOT_PATH . 'public/uploads', $newName);
    if ($info) {
        $result[] = '/uploads/' . $info->getSaveName();
    }
}
return json(['code'=>200, 'data'=>$result]);