Programmation PHP/Commentaires
Principe.
Les commentaires sont en réalité des portions de texte qui ne seront pas interprétées par PHP et ne seront visibles que dans le code source. Ils jouent un rôle très important dans la réalisation et la mise à jour d'un script : en effet, les commentaires rendent le code plus lisible et peuvent aider les éventuelles personnes qui souhaitent retravailler votre script. En effet, si les commentaires sont très utiles aux programmeurs seuls, ils le sont encore plus lors du travail en équipe.
Il existe trois façons différentes d'ajouter des commentaires à son script PHP :
<?php
// encore un commentaire PHP
/* et encore 
 un 
 autre, 
 mais sur plusieurs lignes cette fois-ci ! */
Annotations.
Il existe des logiciels qui génèrent une documentation complète à partir des commentaires insérés dans le code du programme. De là est apparue une certaine forme de standardisation de ceux-ci afin de faciliter la génération de documentation, appelée . On peut en effet ajouter des commentaires structurés pour permettre de générer une documentation automatique via PEAR ou . En pratique, cela se traduit par des mots-clés interprétés, précédés d'un arobase, appelés "annotations".
Exemple :
Les annotations permettent de plus, aux IDE d'en déduire l'autocomplétion, et aident les analyseurs de code statique à garantir la qualité du code. Elles étaient les seules à pouvoir préciser certains types de variables avant l'apparition des et en PHP7.
Exemple de commentaires indispensables avant PHP7 :
class MyEntity
 /** @var int|null */
 private $id;
 * @return int|null
 public function getId()
 return $this->id;
Depuis PHP7 :
class MyEntity
 private int $id;
 public function getId(): ?int
 return $this->id;
Attributs.
Depuis PHP8, il existe des attributs, représentés par des mots-clés suivant un croisillon, pour préciser des informations (s) sur les classes, fonctions, constantes ou variables. Ex :
<?php
 #[\ReturnTypeWillChange]
 public function getMixedData()
 return $this->mixedData;
Cet attribut sert à ne pas ajouter de warning si le type retourné ne peut pas être déterminé.
Il en existe aussi d'autres comme :
Les attributs d'une classe peuvent être récupérés à l'exécution avec : ReflexionClass()->getAttributes().

Fonctionnement d'un ordinateur/Encodage, traitement, décodage

Le langage CSS/Valeurs et unités/Couleur

<includeonly>|-
Cosmologie/Résoudre les équations de Friedmann newtoniennes