Skip to content

Le code

Axel Viala edited this page Feb 4, 2017 · 17 revisions

Plusieurs concepts aujourd’hui un peut obscurs méritent sûrement d’être mis au jour:

Conventions

JavaScript - ES6

http://exploringjs.com/es6/index.html#toc_ch_modules

Utilisation de JQuery?

A éviter dans les nouvelles sources si possible si non avec parcimonie.

Déclarations de variables

Ref: http://exploringjs.com/es6/ch_variables.html#const-vs-let-vs-var

TODO: mêttre des exemples...

  • const: Quand on ne change pas la valeur de la variable. (Pas de soucis avec les objets car ce qu'on change n'est pas leur valeur mais ce qu'ils contiennent)
  • let: Quand on désire changer la valeur la variable.
  • var: Jamais utiliser const ou let.

Pas besoin de mettre les « constantes » en majuscule si elles sont locales. Si elles sont globales les rattacher à l'objet window dans le sous-objet window.OressourceEnv en attendant mieux...

Classes/Objets

Ref: ...

Utiliser avec parcimonie les class, limiter au MAXIMUM l'héritage.

Fonctions anonymes/closures/fermetures

Ref: http://exploringjs.com/es6/ch_arrow-functions.html

Préférer les fat arrow function () => {} aux function() { } car elles récupérent le this du context appelant.

if/else while/for/foreach

Toujours mettre les accolades!

PHP5 -> PHP7

Conventions de style

  • indentation de deux espaces
  • commentaires et noms de variables en français

if/else while/for/foreach

  • Utiliser des ternaires si on souhaite renvoyer une valeur. (if-expr)
  • Toujours mettre les accolades! OUI TOUJOURS.
  • Ne pas faire d'assignations dans les conditions.
// Bien

if (condition) {
  /* code */ 
} else { 
  /* code */ 
}

// Cas ou on à une seule instruction/expression dans le if:
// Possible si cela reste lisible.
if (condition) { /* code */ } else { /* code */ }

// Pas bien!
if (condition) 
  /* code */ 
else 
  /* code */

Conventions du code

  • Chemins d’accès aux fichiers RELATIFS dans touts les langages si possible

Classes

À venir mais dans le doute préférer les interfaces à l'héritage.

Fichiers et dossiers

Gestion des accès utilisateurs

A revoir.

Usage des requêtes MySql

Problemes et idées pour le futur