.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

============
Commentaires
============

Tout comme en C#, il existe les commentaires classiques en PHP et les commentaires pouvant servir à la génération automatique de documentation.

**Classique**
=============

.. code-block:: php

   // Permet d'écrire des commentaires sur une ligne

   # Permet d'écrire des commentaire sur une ligne, rarement utilisé

   /*
   Permet d'écrire des 
   commentaires sur
   plusieurs lignes
   */

**PHPDoc**
==========

.. code-block:: php

   /**
   * Somme de deux nombres
   *
   *@param a premier nombre
   *@param b deuxième nombre
   *
   *@return int
   */
   function sum(int a, int b) : int{
       return a + b;
   }

   /** @var string $name */
   $name; // Permet de spécifier le type d'une variable, pratique pour les éditeurs

   /** @var Car $opel */
   $opel = new Car();