Wenn man Scripte schreibt, du nur sehr kurz sind, kommt man meistens ohne Kommentare im Quellcode aus. Sobald dieses aber umfangreicher werden oder mehrere Personen an diesem Quellcode schreiben müssen, dann wird es fast zur Pflicht, dass man sinnvolle Kommentare verwendet.

Was genau sind Kommentare?

Texte, die als Kommenar markiert werden, werden von dem PHP-Parser ignoriert. In den Kommentaren muss daher kein PHP-Code stehen.

Kommentare können ein- oder mehrzeilig sein. Bei einzeiligen Kommentaren steht nur am Anfang des Kommentar entweder ein „//“ oder ein „#“. Mehrzeilige Kommentare haben ein Start- und ein Endsymbol. Nachfolgend ein paar Beispiele für Kommentare:

<?php
   // Ich bin ein Kommentar
   echo 'Hello World'; // Auch ich bin ein Kommentar
   /*
      Ich bin auch ein Kommentar.
      Ich kann aber mehrzeilig sein.
   */
?>

Bei der mehrzeiligen Variante gibt es noch ein weitere Variante. Diese wird genutzt, um die Methoden der Klassen zu beschreiben. Diese Kommentare beginnen mit „/**“. In diese Kommentare kann man dann weitere Informationen zu der Methode schreiben. Die Texte in diesem Kommentar werden dann sogar von den Editoren wie dem ZDE angezeigt, wenn man die Methode aufruft.

<?php
   class test {
      /**
       * Ich bin eine Beschreibung für eine Variable
       *
       * @var string
       */
      var $variable;
 
 
      /**
       * Ich bin eine Beschreibung für eine Methode
       *
       * @param integer $variable
       * @return boolean
       */
      function methode1($variable) {
         // Hier steht irgendwelcher Code
         return true;
      }
 
   }
?>