NOMENCLATURE : NOMMAGE DES CHAMPS DE BASE DE DONNÉE, ET DES VARIABLES

Commentaire de malalam le 25/02/2007 10:36:14 administrateur CS

Hello,

avoir des règles de nommage est une évidence.
Et elles doivent permettre une simple chose : facilité la lecture et la compréhension.
Donc même si ce que tu dis est vrai, perso, P_ID ne veut strictement rien dire pour moi. Alors que PAGE_ID est bien plus parlant.
Quant aux variables PHP : mettre la provenance des variables dans leur nom me parair curieux...si tu as peur d'écraser un $_SESSION['nom'] par un $nom, c'est que tu codes un peu au hasard : tu es censé savoir d'où viennent tes variables, et où elles vont.
Par contre, oui pour un nom indiquant leur fonction ($cout_article, pq pas), mais aussi leur type attendu, ce qui facilite la lecture d'un code : $sFileName, $iCompteur, $aArticles, (nom de fichier de type string, compteur de type entier, tableau d'articles...).
Que tu préfixes, suffixes, ou "camelcasises" n'a pas d'importance. Il faut juste avoir une norme explicite, et s'y tenir.

Commentaire de FhX le 25/02/2007 18:58:44

Moi je pense qu'il n'y a pas forcément besoin de mettre un préfixe sur les noms de variables.
Quand on sait à quoi correspond une variable, on peut allégrement s'en passer.

La méthode la plus simple est le transtypage. Si je fais une classe dans ce style :

class truc {
public $x;
public $y;

public function __construct($x, $y) {
  $this->x = (int) $x;
  $this->y = (int) $y;
}

}

Tu peux être sur et certain que $x et $y sont des entiers. Et qu'à partir du moment ou tu veux faire de la modif, il suffit de t'en assurer en transtypant automatiquement.

Après, si vous voulez vraiment être sur (et que vous faites de la POO), y'a la solution bien grasse et horrible (:p) :

class iVar {
private $content;

public function __construct($var) {
  $this->content = (int) $var;
}

public function Get() {
  return $this->content;
}

public function Set($val) {
  $this->content = (int) $val;
}

}

$ma_variable_entiere = new iVar('10'); // Va me convertir automatiquement ma variable...

Et t'es sur que c'est une variable entière comme ca :)
Pareil pour les chaines, etc...

Et ensuite, lors d'une réutilisation dans une autre classe :

// ....
public function une_methode( iVar $var ) {
  $this->truc = $var;
}

// $var étant un objet instancié depuis iVar, on est sur que le contenu de l'instance $var est de type INTEGER. Donc plus de soucis :)


Bref, un exemple parmi tant d'autres :)

Commentaire de Eregon le 14/01/2008 18:08:16

Bonne idée, mais je pense qu'on pourrait en dire un peu plus à ce sujet :)

Perso, je n'ai aucune envie de faire des variables à la aVar, mais je comprend ce point de vue.

J'essaie de travailler dans des fonctions pas trop grosses où l'on sait ce qu'est la variable juste à son nom. $fields est forcément un array des champs de la bdd, etc

Sinon, je me suis demandé quel nom à donner pour les variables des paramètres des fonctions dans le cas où cette variable est déjà utilisée dans la fonction.

exemple:
Dans une classe de gestion sql,
j'ai une méthode qui trace automatiquement un tableau en html.

public function draw_table($table, $caption = false, $thead = false, $tfoot = false, $order_by = '', $p_fields = '*')
{
...
$fields = $this->get_fields_name;

mysql_query("SELECT $p_fields"...)
...
}

ici, $fields est un array des noms des champs, et p_fields un string des champs séparés par virgule.

Sinon, il y a toujours le moyen de nommer l'array $fields_name, mais je n'aime pas trop...

Bonne continuation pour le tuto

Commentaire de fadelghani le 16/04/2008 17:59:18

Je demande si Malalam  peut nous envoyer un doc ou on trouve les normes q respecter puisqu'il est chargé de corriger .
J aimerai qu'il fait cela merci d avance.