Lire l'articleCet article est la traduction de en PHP Good Practices 1 – Naming Conventions de Wes Shell et parle des bonnes pratiques de nommage concernant les éléments de code PHP.
Lire l'articleCet article est la traduction de en PHP Good Practices 1 – Naming Conventions de Wes Shell et parle des bonnes pratiques de nommage concernant les éléments de code PHP.
Bref et concis, j'aime bien.
Je ne sais pas si c'est dans l'article original, mais j'aurais bien ajouté une convention assez répandue pour les variables et méthodes privée ou protégées :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10 class MyClass { public $publicVar; protected $_privateVar; public function publicMethod() {} private function _privateMethod() {} }
- Avant de poser une question, n'hésitez pas à chercher dans la FAQ et les forums
- Merci d'utiliser les balises de code (# dans l'éditeur)
- N'oubliez pas de vous servir des boutons , et
S.N.A.F.U
C'est court, concis mais il y a 2 lignes qui portent à confusion dans la partie IV :
- Les fonctions et méthodes - camelcase ==> Les fonctions et méthodes - camelCase
- Les variables - camelcase ==> Les fonctions et méthodes - camelCase
Et du coup les exemples pour les variables ne montrent pas cette nuance, il aurait fallu au moins un nom de variable en 2 mots, par exemple $_releaseYear...
Me trompe-je ?
PS: D'ailleurs l'original est bon...
- Mon blog PHP : http://blog.alterphp.com
- "Peace cannot be kept by force, it can only be achieved by Understanding" -- Albert Einstein
Yep , ça c'est perdu dans la traduction
JE corrige ce soir
En lisant cet article, j'ai été surpris de l'absence des liens vers la documentation du Zend Framework.
Zend Frameworks Annexe B : Convention de codage
Cette ressource a un double avantage :
- elle est très complète
- elle offre une excellente base de template quand vous souhaitez écrire un document sur les conventions de code.
Les annexes C et D sont intéressantes aussi dans le sens éducatif mais dépasse la portée de cette article. Ca risquerait de l'alourdir.
Je suis convaincu qu'un paragraphe traitant de la rédaction de ces fameuses conventions de nommages (et proposant un semblant de méthode) serait un plus non négligeable et qui est malheureusement absent de bien des tutoriaux
L'article est concis, et efficace. Le pourquoi des conventions de nommages est très bien traité et incite à rechercher plus loin.
C'est justement le plus loin où ça manque de ressources externes ou existantes. C'est du beau travail.
Il existe beaucoup d'article sur les conventions de nommages (un peu trop meme), c'est difficile pour quelqu'un souhaitant approfondir de mener des recherches et de tomber sur les bons articles.
Quelques ressources seraient génial.
Vous avez un bloqueur de publicités installé.
Le Club Developpez.com n'affiche que des publicités IT, discrètes et non intrusives.
Afin que nous puissions continuer à vous fournir gratuitement du contenu de qualité, merci de nous soutenir en désactivant votre bloqueur de publicités sur Developpez.com.
Partager