Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

[OpenAPI] multipart/form-data not generated

已关闭
#7,436 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
45/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
停滞
技术栈
openapi, php

调研方向

首先使用输入格式为 multipart/form-data 的 ApiResource 示例,对比提交 bd7b60e5acad35fbfe15a5abfd4569496958f933 前后的 OpenAPI 生成结果。跟踪 requestBody 的生成,并验证生成的 openapi.json 和 Swagger UI 包含 multipart 字段,而不是空的 requestBody。

由索引模型根据 Issue 内容生成。

描述

OpenAPI Serializer

API Platform version(s) affected: 4.2.0

Since this commit : https://github.com/api-platform/openapi/commit/bd7b60e5acad35fbfe15a5abfd4569496958f933
The OpenApi requestBody is empty for multipart/form-data inputFormats.
Swagger UI (and openapi.json) were successfully managed.

I would be happy to make a PR but not sure if it's really a regression or an unwanted feature before.

Here you have the ApiResource used:

#[ApiResource(
    operations: [
        new Post(
            inputFormats: ['multipart' => ['multipart/form-data']],
        ),
)]
class TheResource {
    public ?ImportTaskType $type = null;
    public ?UploadedFile $clientFileUpload = null;
}

Here you have some swagger UI.

Before:
Image

After:
Image

主要语言
PHP
星标
2.6k
派生
989
平均合并
2 天 2 小时
30 天内合并 PR
101

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

api-platform/core 的其他 Issue

查看 api-platform/core 的全部 Issue

相似的 Issue

更多 PHP Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。