La parole est aux speakers : Gina Banyard
Jusqu’au Forum PHP 2025, retrouvez nos interviews de speakers pour mieux comprendre leur parcours et le sujet qu’ils ou elles aborderont lors de leur conférence !
La conférence
Codifier PHP : une nouvelle génération d'outillage pour la documentation30 ans de PHP et donc 30 ans à documenter PHP au fur et à mesure de son évolution. Dans cette conférence, nous verrons comment la documentation de PHP est écrite, un tour d'horizon de la procédure de rendue, et quels outils pas forcément adéquats, nous utilisons pour maintenir la documentation au fur et à mesure des nouvelles versions. Je présenterai aussi un nouvel outil en cours de développement qui utilise la nouvelle API DOM de PHP 8.4 et BetterReflection pour faciliter la documentation des changements introduites dans les nouvelles version de PHP et pour l'écriture du guide de migration. |
Cécile HAMEREL - HJK 09/10/2025 11:55-12:35 |
Quel impact penses-tu que la documentation de PHP a eu sur son adoption ?
Personnellement, je trouve le format de la documentation de PHP extrêmement pratique à naviguer. Le fait que la plupart des fonctions communes ont des exemples et une section « Voir aussi » existe aident à trouver ce dont on a besoin.
Comparé à la documentation officielle d’autres langages de programmation où toutes les fonctions d’un module sont sur une même page les unes après les autres, souvent sans exemples, l’impact de la documentation de PHP me semble évident.
Une chose qu’on disait habituellement en interne, c’est que la doc de PHP était state of the art en 2005-2010, le problème, c’est qu’on est aujourd’hui toujours dans cet état 15-20 ans après !
Tu bénéficies du soutien de la PHP Foundation. Comment répartis-tu ton temps entre le temps dédié à la PHP Foundation et les autres projets ?
Je suis financée à temps plein par la fondation, et on est assez libre de dédier notre temps sur divers projets tant que ça touche à PHP lui-même.
En général, je passe un tiers à la moitié de mon temps à faire de la code review, lire la liste interne, participer aux discussions pour les RFC, corriger des bugs mineurs, etc.
Le reste du temps, ce que je fais est assez varié et dépend d’où on est dans le cycle de la version. En période beta c’est finaliser les features et dépréciations votées. Proche de la release; c’est beaucoup de documentation, et sinon c’est expérimenter sur des nouvelles features ou faire du refactoring
Qu’est-ce qui a changé sur la gestion du site et la documentation depuis l’arrivée de la PHP Foundation ?
En réalité, pas tant que ça, il y a eu une migration du serveur pour consolider notre usage et moderniser nos machines, mais la gestion reste plus ou moins la même.
Ce qui a changé plutôt, c’est le fait de pouvoir dédier du temps à améliorer la documentation et le site, tel que la nouvelle page pour télécharger PHP, ou rendre les exemples utiles et exécutables avec WASM. Ou me permettre de réaliser un nouvel outil pour s’assurer que la documentation est à jour et rédiger partiellement le guide de migration automatiquement, outil dont je parlerai lors de ma conférence !
Une conférence présentée par
 Gina BANYARD |
Gina est financée par la PHP Foundation pour maintenir et améliorer PHP. Elle maintient aussi régulièrement la documentation de PHP et est en charge de la traduction française de celle-ci. |
Autres interviews
- La parole est aux speakers : Maxime Huran
- La parole est aux speakers : Clément Talleu
- La parole est aux speakers : Jori Stein
- La parole est aux speakers : Baptiste Langlade
- La parole est aux speakers : Thibaut Soulcié
- La parole est aux speakers : Olivier Mairet
- La parole est aux speakers : Amaury Bouchard
- La parole est aux speakers : François Zaninotto
- La parole est aux speakers : Damien Alexandre
- La parole est aux speakers : Louis Vareille