Jane supporte maintenant JSON Schema 2020–12 et OpenAPI 3.1

La version v7.11.0 de Jane PHP, le générateur de client d’API et de Normalizer, est désormais disponible. Cette mise à jour majeure du moteur de génération se concentre sur l’alignement avec les derniers standards de l’industrie via le support de JSON Schema 2020–12 et d’OpenAPI 3.1.

Section intitulée evolutions-majeures🚀 Évolutions majeures

Section intitulée support-de-json-schema-2020–12Support de JSON Schema 2020–12

L’un des changements les plus importants introduits dans cette version est l’intégration du support pour JSON Schema 2020–12 (PR #918). Cette mise à jour permet à Jane de traiter des schémas de données beaucoup plus modernes et complexes, offrant ainsi une sémantique plus riche pour la description de vos structures.

Il est important de noter que cette évolution a été pensée pour être totalement transparente : Jane conserve une rétrocompatibilité avec la draft 2019–09. Vous pouvez donc bénéficier des dernières avancées sans craindre pour vos schémas existants.

Cette double compatibilité permet à l’outil d’offrir une précision accrue dans deux domaines :

• La génération des modèles PHP : Les classes générées reflètent plus fidèlement les contraintes et relations définies dans vos schémas, réduisant ainsi le besoin d’ajustements manuels.
• La validation des données : Le support de ces spécifications garantit que la logique de validation intégrée est en parfaite adéquation avec les exigences modernes des API.

Section intitulée support-d-openapi-3–1Support d’OpenAPI 3.1

L’autre pilier de cette version est le support de la spécification OpenAPI 3.1 (PR #904). Cette mise à jour est structurante car elle aligne enfin le standard OpenAPI sur JSON Schema, simplifiant ainsi la gestion des modèles de données.

Grâce à ce support, Jane exploite nativement les nouvelles capacités du standard :

• Convergence avec JSON Schema : OpenAPI 3.1 devient un « superset » de JSON Schema, permettant à Jane d’interpréter des définitions complexes sans perte d’information.
• Typage natif et nullable : Jane utilise la nouvelle syntaxe pour générer des propriétés PHP au typage exact (ex ?string), assurant une cohérence entre votre contrat d’API et votre code.

Section intitulée nouvelle-documentation-officielle📖 Nouvelle documentation officielle

Parallèlement à ces évolutions techniques, la documentation du projet a reçu un coup de neuf pour offrir une meilleure expérience aux utilisateurs. Elle centralise les guides d’installation, de configuration et d’utilisation pour l’ensemble des composants.

Elle est disponible ici: jane.jolicode.com

Section intitulée ameliorations-continues-et-maintenance🛠️ Améliorations continues et maintenance

Au-delà de ces évolutions majeures, cette version est aussi l’occasion d’un grand nettoyage de printemps pour le projet. Nous avons consolidé la base de code avec une série de correctifs de stabilité, notamment sur la gestion des types numériques dans les query strings, et une mise à jour globale des outils de maintenance. Ces ajustements, bien que plus discrets, garantissent une meilleure fiabilité du générateur et simplifient l’installation des dépendances pour vos projets.

Section intitulée lancez-vous📦 Lancez-vous !

Toutes ces améliorations sont disponibles dès maintenant via le tag v7.11.0. Que vous souhaitiez profiter des dernières spécifications OpenAPI ou simplement bénéficier d’un moteur de génération plus robuste, nous vous encourageons vivement à mettre à jour vos projets :

composer update jane-php/* -W

N’hésitez pas à tester ces nouveautés, à explorer la nouvelle documentation et à nous faire part de vos retours sur GitHub. Jane continue de grandir grâce à vos usages et vos contributions, alors profitez-en bien !

• 📚 Documentation officielle : jane.jolicode.com
• 💻 Dépôt GitHub : janephp/janephp
• 🚀 Release v7.11.0 : Consulter le changelog