Mes conventions de codage
- Date de publication
- 1/août
2008 - Commentaires
- 3 commentaires
- Tags
Oncle Tom m’a envoyé en douce il y a quelques jours une patate chaude en m’invitant à vous parler de mes conventions de codage. Vaste sujet, et surtout très vite trollesque, de quoi se régaler.
J’avais commencé à mettre le sujet en perspective avec un bref historique de mon expérience du développement informatique, mais ce qui devait être bref s’est révélé plutôt étoffé, donc c’est devenu un article à part entière sur mes aventures informatiques, et il y a tellement à dire que je ne l’ai pas fini... bref, passons tout de suite au cœur du sujet !
En fait, au risque de décevoir, j’ai plus des habitudes que des conventions strictes de codage, et même si j’ai des préférences personnelles, j’essaie en général de m’en tenir aux conventions qui me sont dictées par les projets auxquels je participe.
Après quelques projets sur lesquels j’étais plutôt isolé, comme phpMyChat, et des discussions sur les newsgroups fciwap puis fclp, ma première grosse expérience en matière de conventions de codage est venue avec PEAR1. Des discussions interminables et passionnées2 ont eu lieu sur les mailing-lists du projet lors de l’élaboration des conventions de codage, à laquelle j’ai participé fin 2001. Il était notamment question du choix d’espaces ou tabulations pour l’indentation du code3 ou du positionnement des accolades...
J’approuve au final le choix d’espaces pour les indentations, mais j’étais auparavant plutôt habitué aux tabulations, tout simplement parce que les éditeurs que j’utilisais à l’époque ne savaient pas gérer ces espaces lors de l’utilisation de la touche de tabulation, et surtout que je ne me préoccupais pas du rendu dans un autre éditeur, étant le seul à travailler sur mes projets. Je ne retrouve malheureusement pas l’exemple qui avait fini par convaincre presque tout le monde — dont moi — que les espaces étaient la meilleure solution.
Après, entre 2 et 4 espaces, je trouve que 2 espaces évitent d’avoir trop de décalage quand on a beaucoup de niveaux imbriqués, tout en préservant une bonne lisibilité. « C’est mon choix ».
Quoi qu’il en soit, il ne faut pas oublier non plus que ces conventions de codage sont comme toutes les bonnes pratiques, elles s’enrichissent au fur et à mesure des expériences, et elles évoluent toujours petit à petit, par ajustements successifs.
Côté PHP, donc, j’étais plutôt utilisateur des conventions de PEAR, mais comme je l’ai indiqué plus tôt, j’adopte systématiquement les conventions déjà en place sur les projets auxquels je participe, donc je m’intéresse maintenant à celles de symfony.
Pour le Javascript, rien de bien original, j’utilise grosso modo les mêmes qu’Oncle Tom, mais pour les CSS, je reste basique, pas d’indentation selon la cascade, et un ordre logique plutôt qu’alphabétique.
Bon, la patate est encore chaude bien que passée entre de nombreuses mains, je la refile vite fait à Oliv même s’il a fait un rapide commentaire chez Oncle Tom, NiCoS histoire d’avoir l’avis d’un fan de Django et Clochix !
- Notes
[1] Pour ceux qui ne connaissent pas, PEAR est un entrepôt de classes — et non réellement un framework, même si ce terme est plus attractif — PHP répondant aux problématiques les plus courantes des développements Web.
[2] Oui, OK, trollesques, on peut le dire...
[3] Certains ont même proposer de mélanger tabulations et espaces !
Commentaires
Derniers billets
-
Le retour du gastéropode perdu
Incroyable, je viens de me rendre compte que mon site n’arborait plus son beau logo, sans doute depuis déjà de nombreux mois. Vous auriez pu me prévenir !
- Date de publication
- 3/fév.
2010 - Commentaires
- aucun commentaire
- Tags
-
Citation de ARNO* (aka Arnaud Martin)
La logique de SPIP n’est pas « compliquée » : elle est contraignante, en ce qu’elle tente d’orienter l’utilisateur. Ce qui est très différent.
- Date de publication
- 14/janv.
2010 - Commentaires
- aucun commentaire
- Tags
-
Qui a gagné un million ?
Bon, c’est peu forcément par rapport à tant d’autres sites, mais petit à petit cet humble site personnel lancé début 2001 a de plus en plus de visiteurs, et cela fait forcément plaisir d’avoir atteint un premier million de visites.
- Date de publication
- 28/déc.
2009 - Commentaires
- aucun commentaire
- Tags

Derniers commentaires
Maïeul sur session_start() et exec() ne font pas toujours bon ménage en PHP : Article sans doute très intéressant, mais l’écriture en quasi blanc sur quasi fond noir le rend (...)
Sur Afficher les favicon dans la barre personnelle de Firefox sous Mac OS : + 1 à ta solution merci beaucoup. Elle fonctionne toujours avec Firefox 3.5 (...)
NiKo sur Un menu de navigation toujours visible : C’est absolument excellent :)
Clément sur Ne sous estimez pas l’importance du câble HDMI : On peut aussi en trouver d’au moins aussi bons (certifiés HDMI 1.3c jusqu’à 15m) et moins cher chez (...)
cable hdmi dvi sur Ne sous estimez pas l’importance du câble HDMI : Salut perso j’ai trouvé un super cable hdmi sur le site EcranLounge.com, c est pas de la pub mais (...)
lebrani mohamed sur Les people — dont Petra Nemcova — au service des marques technologiques : tu va bien moi je m’appelle lebrani mohamed je suis au Maroc voila mon ms : (...)
Stéphane Santon sur Amusons nous avec des boucles SPIP et les petits nouveaux #GET, #SET et #ARRAY : Il faudrait préciser que dans le cas où il y a une partie conditionnelle sur la boucle, il ne (...)
gauste sur Amusons nous avec des boucles SPIP et les petits nouveaux #GET, #SET et #ARRAY : 5 décembre 2009 : Le code noir ou foncé sur fond noir de ce site est illisible (...)
Sur Faut-il que j’abandonne SPIP pour DotClear ? : Je vais peut-être faire une intervention hors sujet mais pourquoi ne pas plutôt migrer vers (...)
reno sur Un exemple de jointures entre plusieurs tables dans une boucle SPIP : c’est exactement la problematique dans laquelle j’etais pour realiser cet agenda (...)