Changes to "Guide de style du code" between 2017-05-18 06:02:05 and 2019-04-12 12:42:32

1

2
3


4
5
6

7
8
9
10
11
12
13
14

15
16



17
18


1
2

3
4
5


6






7

8


9
10
11


12
-
+

-
+
+

-
-
+
-
-
-
-
-
-

-
+
-
-
+
+
+
-
-
+
On ne suit pas PSR pour le style, car certaines règles sont délirantes.
Garradin suit les règles de :

Voici donc les règles à essayer de respecter :
* [PSR-1](https://www.php-fig.org/psr/psr-1/) pour le style du code
* [PSR-4](https://www.php-fig.org/psr/psr-4/) pour l'autoloading des classes

  *  Indentation : utilisation de tabulations, pas d'espaces.
  *  Indentation des conditions : retour à la ligne après la condition, et après l'accolade ouvrante. Accolade fermante sur une ligne séparée. Pas de conditions sans accolades. Un espace entre le nom de la fonction et la parenthèse ouvrante.
On suit également les règles de [PSR-2](https://www.php-fig.org/psr/psr-2/) sauf :
  *  Fonctions / méthodes : pas d'espace entre le nom et la parenthèse ouvrante. Indentation idem que les conditions.
  *  Nom des classes : CamelCase
  *  Nom des méthodes : mixedCase
  *  Nom des fonctions et variables : snake_case
  *  Nom des constantes : UPPER_CASE
  *  Taille : essayer de limiter les lignes à 80 ou 120 colonnes si possible…

Exemple :
* Indentation : nous utilisons des tabulations, pas des espaces. Les espaces sont OK pour l'alignement (par exemple tableau PHP).
<pre>if (true && false)
{
* Pas de limite dure sur la largeur de ligne, utilisez la fonction retour à la ligne automatique de votre éditeur de code. C'est mieux d'essayer de limiter la longueur des lignes entre 80 et 120 colonnes, mais ce n'est pas obligatoire.
* Accolades pour les conditions : normalement l'accolade doit être sur la ligne suivante si le corps de la condition fait plus que 3-4 lignes, mais ce n'est pas obligatoire, juste un peu plus lisible.

    Classe::methode($variable, $autre);
}</pre>
L'indentation dans les fichiers HTML (y compris les templates Smartyer et les squelettes) doit être propre et lisible, et conforme à XHTML 5.