Un bloc de code PHP est délimité par une balise d'ouverture .
Les commentaires permettent d'expliquer votre code soit pour générer une documentation technique, soit pour expliciter votre code.
Il est donc indispensable pour la maintenance de vos développements de commenter votre codes.
# Balise a eviter.
// Phrase a commenter
/* Commentaire pris en compte dans
les generateurs de documentation technique.*/
/**
* Class Client
*
* @author Karkam Dvpt
* @copyright Karkam Dvpt
* @version 1.0.1
*/
class Client
{
private $name; //Nom du client
/**
* Client::__construct()
*
* @param String $nom
*/
public function __construct($nom)
{
$this->name = $nom;
}
}
Un bloc d'instruction peut être identifiés par des accolades "{}".
N.B. :Dans d'autres langages, cela permet de limiter la portée (scope) d'une variable, mais en PHP cet effet n'est pas pris en compte.
Le code d'une instruction peut être groupé au moyen de parenthèses "()" afin de faciliter la lecture ou de forcer les priorités.
PHP définit des priorités même s'il n'y a pas de parenthèses, mais il est parfois nécessaire de modifier les priorités
par le langage. Le principe est exactement le même qu'en mathématiques.