如何使用FlightPHP实现文件上传？代码问题求助

问题根源 #

你的代码无法获取完整文件信息的核心原因是前端表单未设置正确的enctype属性。当表单包含文件上传字段时，必须指定enctype="multipart/form-data"，否则服务器仅能接收到文件名，无法获取文件的临时存储路径、大小等关键信息，导致$request->files['imagefile']返回null。

完整解决方案 #

1. 前端表单（必须设置enctype） #

<form action="/regSubTask" method="POST" enctype="multipart/form-data">
    <input type="file" name="imagefile" />
    <button type="submit">上传文件</button>
</form>

2. 后端FlightPHP处理代码 #

Flight::route('POST /regSubTask', function () {
    $request = Flight::request();
    
    // 检查文件是否存在且无上传错误
    if (isset($request->files['imagefile']) && $request->files['imagefile']['error'] == UPLOAD_ERR_OK) {
        $file = $request->files['imagefile'];
        
        // 获取文件核心信息
        $originalName = $file['name'];
        $tmpFilePath = $file['tmp_name'];
        $fileSize = $file['size'];
        $fileType = $file['type'];
        
        // 配置上传目录（确保目录有写入权限）
        $uploadDir = './uploads/';
        // 自动创建目录（如果不存在）
        if (!is_dir($uploadDir)) {
            mkdir($uploadDir, 0755, true);
        }
        
        // 重命名文件避免覆盖（添加唯一前缀）
        $newFileName = uniqid() . '_' . $originalName;
        $targetPath = $uploadDir . $newFileName;
        
        // 移动临时文件到目标目录
        if (move_uploaded_file($tmpFilePath, $targetPath)) {
            echo "文件上传成功，存储路径：{$targetPath}";
        } else {
            echo "文件移动失败，请检查目录权限";
        }
    } else {
        // 处理上传错误
        $errorCode = $request->files['imagefile']['error'] ?? '未知错误';
        echo "文件上传失败，错误码：{$errorCode}";
    }
});

关键注意事项 #

• 必须确保前端表单的enctype属性为multipart/form-data，这是文件上传的必要条件
• 服务器的上传目录需要配置写入权限（如设置为0755）
• 建议对上传文件重命名，避免同名文件覆盖原有内容
• 可根据业务需求添加文件类型、大小的校验逻辑（比如限制仅允许图片格式）

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