Allow a more convenient method of working with "x-" specifications

未关闭

#121 创建于 2021年8月15日 2 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 4/5
预计耗时: 3-5 天
新手友好度: 30/100

Issue 类型: 功能
描述清晰度: 基本清楚
活跃度: 停滞
技术栈: openapi, php
领域: api

调研方向

首先阅读 issue 中链接的 OpenAPI 扩展规范，以及库现有的 getSerializableData() 行为。跟踪关键字属性是如何暴露的，以及 isset() 是如何用于这些属性的。当调用方能够方便地访问包含连字符的扩展名称而不会出现所报告的 PHP 错误，并且现有的序列化 workaround 仍然得到理解时，即视为完成。

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

描述

enhancement

First Point: Excellent project. I've written an OpenApi loader myself. Yours is much better.

Second Point: The openapi specification of keywords allows for the possibility of extending them with the "x-" syntax: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#specification-extensions

In a project I am working on we have made use of this feature. When using cebe/php-openapi I've run into a problem.

openapi requires the use of the "x-" syntax
php interprets "x-" not as a variable (or something similar) but sees the "-" as an operation. Particularly with the function isset()
cebe/php-openapi relies on the native php convention variable/(class attribute names)
When using isset() to determine if a keyword has been specified PHP reports an error. I have been able to work around this problem by using getSerializableData(). However it would be nice and more convenient if one could access openapi variables (keywords) which use a "-" as part of their name.

主要语言: PHP
星标: 500
派生: 99
PR 合并指标: 30 天内没有已合并 PR

贡献指南

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

从这里开始

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

cebe/php-openapi 的其他 Issue

Deprecated warnings in PHP 8.2 未关闭

难度 3/5 1-2 天新手友好度 48/100

cebe/php-openapi#250 · 2025年10月30日创建
BC break in 1.8 未关闭

难度 5/5 一周以上新手友好度 25/100

cebe/php-openapi#247 · 1 条评论 · 1 个 reaction · 2025年9月2日创建
php 8.4 deprecations 未关闭

难度 3/5 1-2 天新手友好度 58/100

cebe/php-openapi#245 · 3 条评论 · 2025年6月24日创建
CLI call to openapi-spec with security in path fails 未关闭

难度 3/5 1-2 天新手友好度 52/100

cebe/php-openapi#242 · 6 条评论 · 1 个 reaction · 2025年5月15日创建
Add support for empty Security Requirement Object (`{}`) in security requirement 未关闭

难度 2/5 1-3 小时新手友好度 55/100

cebe/php-openapi#238 · 2025年5月12日创建

查看 cebe/php-openapi 的全部 Issue

相似的 Issue

bench: run.sh's skip-update message always cites bench/skips.txt 未关闭

tooling

难度 2/5 1-3 小时新手友好度 75/100

svandragt/vivace#313 · 2026年9月24日创建
Monolingual text language selector is too internationalized 未关闭

UX

难度 2/5 1-3 小时新手友好度 70/100

ProfessionalWiki/NeoWiki#1525 · 2026年9月24日创建
Creating a plugin on a Windows PC with carriage returns in plugin comment block 未关闭

难度 2/5 1-3 小时新手友好度 75/100

givanz/Vvveb#526 · 2026年9月24日创建
checkRootlessDocker: in-script cron lock (420ca012) leaks its flock fd into the rootless daemons it starts — watchdog wedged after the first start tick (regression of #756) 未关闭

bug customer-reported

难度 2/5 1-3 小时新手友好度 65/100

MagnaCapax/PMSS#949 · 2026年9月24日创建
responsive-media kses allow-list strips clipPathUnits, collapsing objectBoundingBox clip paths 未关闭

难度 2/5 1-3 小时新手友好度 84/100

Automattic/static-site-importer#1829 · 2026年9月24日创建

更多 PHP Issue