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

Duplicate OperationIds should be considered invalid

未关闭
#181 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

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

调研方向

使用 Reader::readFromJson 重现 duplicate-operationId 示例,然后跟踪 OpenApi::validate 入口点及其委托的验证过程。检查操作是如何收集的,以及唯一性是如何表示的。完成的标准是同一示例返回 false,并包含针对重复 operationIds 的覆盖率。

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

描述

Expected

Calling validate on a \cebe\openapi\spec\OpenApi object containing duplicate operationIds will return false.

Reasoning

OperationIds MUST be unique among all operations described in the API.

Actual

Calling validate on a \cebe\openapi\spec\OpenApi object containing duplicate operationIds returns true.

Example
$api = Reader::readFromJson(<<<JSON
{
  "openapi": "3.0.0",
  "info": {
    "title": "Test API",
    "version": "1.0.0"
  },
  "paths": {
    "/path": {
      "get": {
        "operationId": "op1",
        "responses": {
          "200": {
            "description": "Success"
          }
        }
      },
      "post": {
        "operationId": "op1",
        "responses": {
          "200": {
            "description": "Success"
          }
        }
      }
    }
  }
}
JSON);

var_dump($api->validate()); // bool(true)
主要语言
PHP
星标
500
派生
99
PR 合并指标
30 天内没有已合并 PR

贡献指南

这个仓库没有索引到贡献指南

从这里开始

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

cebe/php-openapi 的其他 Issue

查看 cebe/php-openapi 的全部 Issue

相似的 Issue

更多 PHP Issue

把新 issue 发到你的邮箱

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