Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

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

Offen
  • Stimmt etwas nicht?
#121 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

@fxedel arbeitet bereits daran.

Seit 11.10.2022.

  • #169 von @fxedel — offen

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
30/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Veraltet
Tech-Stack
openapi, php
Bereich
api

Rechercherichtung

Beginne mit dem Lesen der im Issue verlinkten OpenAPI-Erweiterungsspezifikation und dem bestehenden Verhalten von getSerializableData() der Bibliothek. Verfolge, wie Schlüsselwortattribute bereitgestellt werden und wie isset() für sie verwendet wird. Als erledigt gilt die Aufgabe, wenn Aufrufer bequem auf Erweiterungsnamen mit Bindestrichen zugreifen können, ohne den gemeldeten PHP-Fehler zu erhalten, wobei der bestehende Serialisierungs-Workaround weiterhin verständlich bleibt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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.
Vorherrschende Sprache
PHP
Sterne
501
Forks
99
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

  • Enthält ein Dockerfile oder eine Docker-Compose-Datei
  • Keine Pull-Request-Vorlage
  • Kein Beitragsleitfaden

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus cebe/php-openapi

Alle Issues in cebe/php-openapi

Ähnliche Issues

Weitere Issues zu PHP

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.