Partage d’expérience pratique du projet sur les spécifications PSR2 et PSR4

Partage de l'expérience pratique du projet des spécifications PSR2 et PSR4

Avant-propos

Dans le développement de logiciels modernes, il est très important de suivre des normes de codage unifiées, ce qui peut améliorer la lisibilité et la maintenabilité du code et réduire les frictions du travail d'équipe. PHP-FIG (PHP Framework Interop Group) a développé une série de spécifications PSR dont les plus connues sont PSR2 et PSR4. Cet article partagera quelques expériences dans le suivi des spécifications PSR2 et PSR4 dans la pratique du projet et fournira quelques exemples de code spécifiques.

Spécification PSR2

La spécification PSR2 se concentre principalement sur l'uniformité du style et du formatage du code. Voici quelques suggestions de la spécification PSR2 que nous suivons dans nos projets :

1. Indentation du code : utilisez 4 espaces pour l'indentation de niveau au lieu de tabulations.

   // 错误的示例
   function helloWorld()
   {
   ∙∙echo "Hello World!";
   }
   
   // 正确的示例
   function helloWorld()
   {
   ∙∙∙∙echo "Hello World!";
   }

2. Limite de largeur de ligne : chaque ligne de code ne doit pas dépasser 80 caractères de large.

   // 错误的示例
   function longMethodNameWithTooManyParametersAndALongReturnStatement(
   ∙∙$parameter1, $parameter2, $parameter3, $parameter4, $parameter5
   )
   {
   ∙∙∙∙//...
   }
   
   // 正确的示例
   function longMethodNameWithTooManyParametersAndALongReturnStatement(
   ∙∙$parameter1,
   ∙∙$parameter2,
   ∙∙$parameter3,
   ∙∙$parameter4,
   ∙∙$parameter5
   )
   {
   ∙∙∙∙//...
   }

3. Ligne vierge : utilisez une ligne vierge pour séparer les méthodes d'une classe et les blocs logiques de méthodes.

   // 错误的示例
   class MyClass
   {
   ∙∙public function method1()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   ∙∙public function method2()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   }
   
   // 正确的示例
   class MyClass
   {
   ∙∙public function method1()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   
   ∙∙public function method2()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   }

Spécification PSR4
La spécification PSR4 se concentre principalement sur la mise en œuvre du chargement automatique. Voici quelques expériences des spécifications PSR4 que nous suivons dans le projet :

1. Espace de noms et nom de classe : Chaque classe correspond à un fichier indépendant, le nom de fichier et le nom de classe sont cohérents et organisés à l'aide d'espaces de noms.

   // 文件路径：src/MyNamespace/MyClass.php
   namespace MyNamespace;
   
   class MyClass
   {
   ∙∙//...
   }

2. Chargement automatique : utilisez Composer pour gérer les dépendances et utilisez sa fonction de chargement automatique dans votre projet.

   // composer.json
   {
   ∙∙"autoload": {
   ∙∙∙∙"psr-4": {
   ∙∙∙∙∙∙"MyNamespace\": "src/"
   ∙∙∙∙}
   ∙∙}
   }

3. Structure de répertoires : La structure de répertoires qui suit la spécification PSR4 peut améliorer l'organisation et la maintenabilité du code.

   // 错误的示例
   src/
   ∙∙MyClass.php
   ∙∙MyOtherClass.php
   
   // 正确的示例
   src/
   ∙∙MyNamespace/
   ∙∙∙∙MyClass.php
   ∙∙∙∙MyOtherClass.php

Conclusion

Suivre les spécifications PSR2 et PSR4 peut rendre votre code plus cohérent et lisible, et améliorer l'efficacité de la collaboration en équipe. Cet article décrit certaines de nos expériences suite à ces spécifications dans des projets et fournit quelques exemples de code concrets. Bien entendu, les spécifications ne sont que la base. Nous devons également appliquer ces spécifications de manière flexible en fonction des besoins des projets réels afin d'améliorer la qualité du code et l'efficacité du développement. J'espère que ces expériences vous seront utiles dans vos projets utilisant les spécifications PSR2 et PSR4.

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!