Quelques règles simples vous permettent de livrer du code aussi pur que possible. Avec cela en tête, mes conventions de code sont les suivantes :
Imitez la présentation du code...
Une étude de Forrester Research montre que les entreprises adoptent de plus en plus les méthodes Agiles de développement.
Pour ceux qui recherchent une convention de codage, je viens de tomber sur une proposition draft de Régis Gaidot, disponible sur son site.
Les conventions de codage permettent d'uniformiser un programme, et de le comprendre plus facilement. Par exemple, si toutes les constantes sont en majuscules, il sera facile de les répérer dans le projet, même si vous n'avez pas écrit la partie de code que vous lisez. Les conventions de codage permettent aussi d'améliorer la sécurité en mettant en valeur les variables sécuritaires des variables entrantes.
Le plus important avec des conventions de codage, c'est de les suivre. Le reste est affaire de gout.
Joel On Software a un magnifique article sur la propreté du code. Il aborde ainsi la perception même du code propre (qu'est-ce qui est propre? qu'est ce qui ne l'est pas), puis les conventions de codage et la notation hongroise. Rien de tout cela n'est spécifique à PHP, mais tout y est applicable. Un bon (et long) moment de lecture.
Le Genre dans
les Conventions de RIO
Les
Conventions des Nations unies sur la biodiversité, sur les changements
climatiques (UNFCCC) et sur la lutte contre la désertification (UNCCD) ; connues sous
l'appellation de " Conventions de Rio " (...)
Robert Peake produit un article dans lequel il explique que PHP devrait se parer d'un atout sérieux pour assurer sa progression en entreprise : les conventions de codage. Il s'agit de permettre à un manager de comprendre et aimer le code dès la première rencontre.
Un article plus détaillé paraîtra dans le prochaine PHP-Magazine international (version anglaise), mais Robert livre déjà les conseils de base :
+ Utilisez PHPDocumentor pour documenter toutes les fonctions et classes
+ Séparez le code du contenu (HTML)
+ Séparez le contenu de la présentation (CSS)
Plusieurs liens sont donnés en référence.
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité
Les développeurs sont 43% à avoir recours à des démarches de travail formalisées. Au sein de ce groupe, les méthodes Agiles arrivent largement en tête des outils les plus prisés. Actualité