II. Normes▲
La communauté PHP est large et diverse, composée d'innombrables bibliothèques, de frameworks et de composants. Il est courant pour les développeurs PHP de choisir plusieurs d'entre eux et de les combiner en un seul projet. Il est important que le code PHP adhère (de façon aussi proche que possible) à un style commun pour rendre le partage plus facile entre développeurs et de garder une certaine cohérence avec l'utilisation de code tiers.
Le Framework Interop Group a proposé et approuvé une série de conventions de codage. Celles qui sont liées aux conventions d'écriture sont le PSR-0, PSR-1, PSR-2 et PSR-4. Ces recommandations sont un ensemble de règles que certains projets ont adoptées comme Drupal, Zend, Symfony, CakePHP, phpBB, AWS SDK, FuelPHP, Lithium, etc. Vous pouvez les utiliser dans vos projets ou bien la vôtre si vous en avez une.
Idéalement, vous devriez écrire du code PHP qui adhère à des standards connus. Cela peut être une combinaison des PSR ou un des standards créés par PEAR ou Zend.
- En savoir plus sur PSR-0
- En savoir plus sur PSR-1
- En savoir plus sur PSR-2
- En savoir plus sur PSR-4
- Lire les conventions de codage de PEAR
- Lire les conventions de codage de Zend
- Lire les conventions de codage de Symfony
Vous pouvez utiliser PHP_CodeSniffer pour vérifier que votre code respecte une de ces recommandations. Des plugins pour des éditeurs de texte comme Sublime Text 2 vous permettent d'avoir un aperçu des écarts en temps réel.
Utilisez le PHP Coding Standards Fixer de Fabien Potencier afin de formater automatiquement la syntaxe de votre code selon les standards définis, ce qui vous évite de le faire vous-même à la main.
Faites en sorte que l'infrastructure de votre code et que les noms des variables choisis soient en anglais. Les commentaires peuvent être écrits dans n'importe quelle langue du moment que l'ensemble des personnes ayant à travailler dessus puissent le comprendre.
