Aller au contenu principal

Prettier pour PHP 0.1 : Première version alpha 🎉

· 3 minutes de lecture
Christian Zosel
Christian Zosel
Traduction Bêta Non Officielle

Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →

Après plus de 200 pull requests fusionnées depuis mi-décembre 2017, nous sommes heureux d'annoncer la première version alpha de Prettier pour PHP. Dans cet article, nous vous proposons un bref aperçu du fonctionnement du plugin, de sa philosophie et des futures évolutions.

Comment fonctionne-t-il ?​

Ajouter la prise en charge d'un nouveau langage à Prettier nécessite deux éléments :

  • Un analyseur (parser) qui transforme votre code source en arbre syntaxique abstrait (AST). Comme Prettier est écrit en JavaScript, nous utilisons php-parser, un analyseur PHP écrit en JS.

  • Un formateur (printer) qui convertit l'AST dans un format spécial appelé doc, requis par Prettier pour réaliser sa magie. Il s'agit essentiellement de votre code source enrichi d'informations sur les emplacements possibles de sauts de ligne, l'indentation, etc.

Si nous avons pu bénéficier de travaux existants pour l'analyse, le formateur a dû être développé entièrement pour supporter tous les types de nœuds AST de PHP. Notre première version alpha signifie que nous sommes confiants dans sa capacité à reformater votre code sans le corrompre.

Pour en savoir plus sur l'API des plugins, consultez la documentation.

Philosophie​

Lorsqu'on crée un formateur de code, on peut être tenté d'ajouter de nombreuses options pour couvrir tous les styles existants. Le plugin PHP reste fidèle à la philosophie opinionated de Prettier et n'introduit aucune nouvelle option. Nous avons plutôt identifié PSR-1, PSR-2 et PSR-12 comme styles de codage parmi les plus populaires dans la communauté PHP, et décidé de les utiliser comme référence pour formater le code PHP.

L'expérience acquise avec Prettier pour JavaScript nous conforte dans l'idée que proposer le minimum d'options possible est l'un de ses principaux atouts. Après la première version stable, nous envisagerons d'ajouter un ensemble très restreint d'options pour les choix stylistiques les plus controversés (ex. style des accolades), en conservant une approche conservatrice.

Prochaines étapes​

Pour notre première version stable, les jalons suivants restent à atteindre :

  1. Garantir à 100% l'absence de corruption du code lors du formatage.

    Nous en sommes déjà très proches aujourd'hui.

  2. Un rendu esthétique

    Le plugin ne mériterait pas son nom si le résultat n'était pas joli. Bien que déjà satisfaisant, traiter tous les cas particuliers demandera encore du travail.

  3. Intégrations

    Vous pouvez dès aujourd'hui tester le plugin en ligne de commande en suivant les instructions du README. La prise en charge dans votre éditeur préféré pourrait ne pas fonctionner encore (voir les problèmes associés pour VS Code, Atom et Vim). De plus, le plugin PHP n'est pas encore intégré au playground de Prettier.

Êtes-vous enthousiaste à l'idée de Prettier pour PHP ? Aidez-nous à atteindre notre première version stable en :