Nomenclature - NicolasGlassey/PROJWEB_WEBELWEISS GitHub Wiki

Introduction

Voici la page regroupent la nomenclature mis en place pour ce site.

Fichiers

Pour tous les fichiers une nomenclature en CamelCase doit être mise en place.

Ex. homePage.php

Fonction et variables

Toutes fonction et variable doivent utiliser une nomenclature en CamelCase.

Ex. function addUser()

Ex. $userEmail

Commentaires

Les commentaires de fonction se trouvent au dessus de la fonction, elle doit être définie au minimum par :

  • @brief -> il résume la fonction

les commentaires d'une partie de code se trouvent au dessus de la partie de code à commenter.

En-tête

Chaque fichiers aura une entête spécifique :

Project : ProgWEB - Images upload site

 @file      NOM_DU_FICHIER

 @brief     RESUME_DE_LA_FONCTION_DU_FICHIER

 @author    Created by NOM_DE_L'AUTEUR

 @version   VERSION (DATE)

PHP STORM - Automatisation

Sous 'Settings/Editor/File and Code Template/PHP File' Ajoutez

/**
 * Project : ProgWEB - Images upload site
 * @file      ${FILE_NAME}
 * @brief     This --- is used to ---
 * @author    Created by ${USER}
 * @version   1.0 (${DATE})
*/

Spécificité

Les nom de fichier, fonction ou variable comportant le mot "ID" doit s'écrire entièrement en majuscule.