Car il fallait que ça tombe sur moi : Skreo, de la plate-forme Eklablog m’a transmis une chaîne pour parler de ses conventions en programmation.

Notation

Je n’utilise pas CamelCase ou autre notation Hongroise, je préfère de longs noms explicites pour savoir exactement sur quoi je bosse 🙂
Dans mes bases de données, par contre, mes champs ont des noms de type [initiale unique de la table]_[contenu du champ], ce qui permet de faire des jointures sans avoir à renommer de champ.

Indentation

J’indente avec la touche TAB, je sais, c’est mal. Mais sous Notepad++, ça donne exactement 4 espaces, donc pas si coupable que ça 🙂

Accolades

Je mets l’accolade de départ un espace après l’instruction, et celle de fermeture, seule sur sa ligne.
Je ne mets jamais d’accolades pour les instructions monolignes, je saute une ligne et je rajoute un TAB.

Espaces

Toujours un espace avant et après les opérandes, et après une virgule. à part ça, tout dépend du script ( longueurs max des instructions, etc ).

Guillemets

J’utilise toujours des simples-quotes ‘, sauf pour les caractères d’échappement ( « \n », « \t » ).

Commentaires

Les commentaires me servent essentiellement à annoter des bouts de code sur lesquels je compte revenir plus tard, ou à expliquer ma méthode sur des scripts amenés à être partagés.
Sinon, en règle générale, je comprends plutôt bien mes scripts à la relecture 😉

Soyons fous, un petit exemple de code :

<?php
$dir_open = opendir('type/');
while ($file = readdir($dir_open)) {
	if($file != '.' && $file != '..' && $file != '')
		echo  '&gt;'.$file."\n";
	else
		echo  '&gt;'.'null'."\n";
}
?>

Je passe la chaine à … ShadowKris, Br1o et JarodXXX. Et, pour le faire grave, à toi, lecteur 😉

Tags : , ,