Les Normes du PHP

1. Les Normes du PHP Règles et devoirs du PHP

2. Règles des extensions de fichiers • .php • .inc.php • .lib.php • .class.<nom de la classe>.inc.php

3. Contraintes nom de fichier • Tiret bas « _ » • Tiret demi-cadratin « - » • Caractères spéciaux sont interdits.

4. Format des fichiers • PHP ou HTML stocké dans du texte ASCII.

5. Inclusion des scripts • Instruction : include • require • include_once • require_once • Différence entre include et require : • Include : gestion des erreurs • Require : erreur fatal

6. TAG php • <?php • ?> pour délimiter le code PHP

7. Séparation PHP/HTML • Une instruction par ligne par plus • Fichier source pas plus de 500 lignes <select id="lstAnnee" name="lstAnnee"> <?php $anCours = date("Y"); for ( $an = $anCours – 5 ; $an <= $anCours + 5 ; $an++ ) { ?> <option value="<?phpecho $an ; ">echo $an; ?></option> <?php } ?> </select>

8. Indentation et longueur des lignes • Le pas d’indentation fixe est de 4 caractères • 4 espaces sans tabulation réelle

9. Blocs logiques • Les blocs logiques doivent être délimité par des accolades (même si il ne comporte qu’une seule instruction) • Les instructions contenues dans un bloc ont un niveau supérieur d’indentation

10. Appels de fonctions/méthodes • Fonction sans espace entre nom de la fonction et le premier paramètre

11. Fichier de code PHP • Chaque fichier de code PHP doit avoir un bloc d’en tête en haut du document qui contient au minimum les balises PHP.

12. Fonctions • Une fonction doit être précédée du bloc de documentation contenant au minimum : • Une description de la fonction • Tout les arguments • Toutes les valeurs de retours possibles.

13. Commentaires • On note différemment les commentaires qu’ils soient mono ligne ou pluri ligne. • On écrit // pour un comment mono ligne • Et /* • */ pour un commentaire pluri ligne.

14. Nommage des identificateurs • Les fonctions • Les paramètres formels des fonctions • Les constantes • Les variables locales • Les variables de session

15. Nommage des fonctions et des constantes et des variables • Dans les fonctions « _ » ne sont pas permis dans le nombre. • Une constante est déclaré grâce à la commande define() le mot doit être en majuscule. • Les variables ne sont nommées qu’avec des caractères alphanumérique.

16. Fonction méthode • Une fonction doit effectuer un seul traitement. • Chaque fonction doit être construite de manière à posséder la plus forte cohésion et la plus grande indépendance possible par rapport à son environnement.

17. Paramètres Fonctions • Pas plus de cinq paramètres • Tout dépassement limite doit être justifié

18. Instructions d’affectation abrégés • Ex: $total=$total*0.90; • Devient $total*=0,90;

19. Parenthèses • Il faut impérativement mettre des parenthèses lorsque l’expression peut être confuse.

20. Interdiction des instructions imbriquées • Une expression ne doit contenir que : • Des variables • Des constantes • Des appels de fonctions dont les arguments ne sont pas eux-mêmes des éléments des variables.

21. Instruction Switch • Default obligatoire • Chaque cas doit être terminé par un break • Break obligatoire à la fin du default switch (choix) { case expression1 : instructions /* pas de break */ case expression2 : case expression3 :instructions break; default : instructions; break;}

22. Instruction if • Éviter les abréviations sauf si les conditions suivantes sont réunies : if ($a > $b) { $maxi = $a;} else { $maxi = $b;} $maxi = ($a > $b) ? $a : $b;

23. Types d’éléments

24. GET et POST • GET donne les noms et valeurs de l’URL de la requête HTTP. • POST donne les noms et valeurs dans le corps de la requête HTTP

25. Protection des données • Fonction php prédéfinies tqaddslashes ou mysql_real_escape_string • Ou alors les directives phpmagic_quote_gpc peuvent prendre la valeur on ou off