Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Support OpenAPI 3.1

Ouverte
#101 2 commentaires 15 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
35/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
À l'abandon
Stack technique
openapi, php
Domaine
api

Piste de recherche

Commencez par examiner les notes de migration d’OpenAPI 3.0 vers 3.1 liées dans l’issue et comparez-les avec la gestion actuelle d’OpenAPI par cette bibliothèque. Le travail sera considéré comme terminé lorsque la bibliothèque prendra en charge les changements 3.1 indiqués, notamment les types nullable, les bornes exclusives directes, les exemples, les charges utiles de téléversement de fichiers et les dialectes JSON Schema explicites.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

openapi 3.1

OpenAPI 3.1 has just been released... Can we hope for support in this library?

Changes in the spec seems really small, but there are some small BCs that could complicate the stuff further: https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0

Main differences:

  • no more nullable
-type: string
-nullable: true
+type:
+ - "string"
+ - "null" 
  • exclusiveMinimum and exclusiveMaximum are used directly
-minimum: 7
-exclusiveMinimum: true
+exclusiveMinimum: 7
  • examples, no more example
-example: fedora
+examples:
+ - fedora
  • Describing File Upload Payloads
  • declaring JSON Schema dialect explicitly
Langage dominant
PHP
Étoiles
501
Forks
99
Métriques de merge des PR
Aucune PR mergée en 30 j

Préparer son environnement

  • Fournit un Dockerfile ou un fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de cebe/php-openapi

Toutes les issues de cebe/php-openapi

Issues similaires

Plus d'issues PHP

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.