Discussion :

[RideKick]

Cet 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'article

[s.n.a.f.u]

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() {}
}

[pc.bertineau]

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...

[RideKick]

Yep , ça c'est perdu dans la traduction
JE corrige ce soir

[Phelim]

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.