Le PSR est une recommandation standard PHP, formulée par le groupe d'interopérabilité PHP Framework, visant à améliorer la cohérence du code, la lisibilité et la compatibilité des trames croisés. Les normes communes comprennent: 1. Spécifications de base PSR-1, telles que les étiquettes et les conventions de dénomination; 2. Normes de chargement automatiques PSR-4, définissant la classe de classe et de chemin; 3. PSR-12 Style de codage étendu, règles de format raffiné; 4. Interface logarithmique PSR-3, support de la bibliothèque de journaux de prise en charge; 5. Interface de message HTTP PSR-7, pratique pour le développement du middleware et de l'API. Sa valeur se reflète dans l'amélioration de l'efficacité de la collaboration multi-projets, l'amélioration de la prise en charge des outils, la simplification de l'intégration et l'amélioration de l'expertise du code. Les méthodes d'application incluent la configuration du PSR-4 avec le compositeur, de la mise en forme automatique du code à l'aide d'outils, de la suite manuelle des règles PSR-1 et de la mise en ?uvre des interfaces PSR-3 ou PSR-7 dans le développement des composants.

PSR signifie PHP Standards Recommandations. Ils sont un ensemble de normes de codage et de meilleures pratiques créées par le groupe Interop Framework PHP (PHP-FIG), qui est essentiellement un groupe de framework PHP représentant la tentative de standardisation des pratiques communes dans différents projets.

L'idée principale derrière les normes PSR est de rendre le code PHP plus cohérent, lisible et interopérable entre différents cadres et bibliothèques.

Quelles sont les normes PSR communes?

Il existe pas mal de PSR, mais les plus couramment utilisés dans le développement de PHP moderne comprennent:

• PSR-1 : Norme de codage de base - Couvre des choses comme l'utilisation correctement des balises <?php , en utilisant uniquement UTF-8, et des conventions de dénomination de classe / méthode suivantes.
• PSR-4 : Norme de mise en scène - définit comment les classes doivent être mappées sur les chemins de fichier afin que le fonctionnement automatique fonctionne en douceur.
• PSR-12 (style de codage étendu): construit sur PSR-1 et ajoute des règles de formatage plus détaillées, comme l'espacement autour des opérateurs, les longueurs de ligne et le formatage de la structure de contr?le.
• PSR-3 : Interface Logger - Fournit une interface commune pour les bibliothèques de journalisation afin que vous puissiez échanger un enregistreur pour un autre sans réécrire votre application.
• PSR-7 : interfaces de message HTTP - Définit les interfaces pour les demandes et les réponses HTTP, utile si vous construisez ou travaillez avec des middleware ou des API.

Ce ne sont pas obligatoires - ce sont des recommandations , mais ils sont devenus largement adoptés, en particulier dans des cadres comme Laravel, Symfony et Laminas.

Pourquoi les normes PSR sont-elles importantes?

L'utilisation de normes PSR peut ne pas être essentielle lorsque vous travaillez seul, mais une fois que vous collaborez ou partagez du code, leur valeur devient évidente.

Voici pourquoi ils comptent:

• LIMITABILITé DES PROJETS : Lorsque plusieurs développeurs suivent les mêmes normes, le saut entre les bases de code devient beaucoup plus fluide. Vous n'avez pas à publier des règles de style chaque fois que vous changez de frameworks.

• Meilleur support d'outillage : des outils tels que PHP-CS-Fixer, PHP_CODESNIFFER et IDE peuvent être du code automatique basé sur les normes PSR. Cela facilite l'application de la cohérence automatiquement.

• Intégration plus facile : les bibliothèques construites avec la mise à jour PSR-4 fonctionnent bien ensemble car elles suivent une structure prévisible. Il en va de même pour les interfaces HTTP PSR-7 - si deux packages les utilisent, ils peuvent souvent se brancher de manière transparente.

• Apparence professionnelle : le code qui suit les normes reconnues semble plus empoisonné et plus professionnel, en particulier lorsqu'il est open source ou partagé avec les nouveaux membres de l'équipe.

Pensez aux règles de circulation convenues comme convenues - elles ne vous obligent pas à conduire une certaine voiture, mais elles aident tout le monde à se déplacer en toute sécurité et efficacement.

Comment appliquer les normes PSR dans votre projet

Si vous commencez un nouveau projet ou nettoyez un ancien, voici comment mettre en jeu PSR:

• Utilisez PSR-4 AutoLoading via Composer: Définissez votre espace de noms et le mappage du répertoire dans composer.json , puis exécutez composer dump-autoload -o .

• Formatez votre code avec PHP-CS-FIXer ou PHP_CODESNIFFER : Ces outils peuvent vérifier et fixer automatiquement la conformité PSR-12.

• Tenez-vous en fonction des règles PSR-1 de base manuellement si vous n'utilisez pas encore d'outils:

  • Noms de classe dans StudlyCaps
  • Noms de méthode dans CamelCase
  • Utilisez toujours des balises complètes = <?php

• Si vous construisez des composants réutilisables, envisagez d'implémenter les interfaces PSR-3 ou PSR-7 afin que d'autres puissent s'intégrer plus facilement.

De nombreux IDE modernes (comme PHPSTorm ou VSCODE avec des extensions PHP) peuvent être du code de format automatique pour correspondre au PSR-12 au moment où vous tapez, ce qui fait de l'embo?tement à la norme presque sans effort.

Dans la pratique, les normes de PSR ne sont pas à la fin de la vie - il s'agit de faciliter la vie lorsque vous travaillez avec PHP à grande échelle. La plupart des frameworks les suivent déjà, donc aligner votre propre code avec ces normes aide à mieux s'asseoir ensemble.

Fondamentalement, c'est tout.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!