/**
 * @annotation  wert
 **/

In letzter Zeit kommt es im Rahmen der Frameworks und Aspektorientierten Programmierung dazu das diese Kommentarzeilen dafür genutzt werden um Meta Informationen zu den Klassen oder Methoden hinzuzufügen.

Diese Informationen haben aber nicht nur informative Bedeutung, sondern auch eine technische Funktion. Beispielsweise kann man damit bestimmte Methoden als Webservice definieren und deren Zugriffsrechte steuern.

Das Framework AMFPHP nutzt diese Funktion um bestimmte PHP Klassen für Flash zur Verfügung zu stellen. Man muss dafür den vorhandenen PHP Code nicht anpassen. Man fügt nur die Annotations hinzu und der Code bleibt sich seiner Verantwortung treu und kümmert sich nur um dass, was seine eigentliche Aufgabe ist.

Typo3 5 wird in seinem neuen Framework auch sehr viel damit arbeiten, da die Entwickler von der Aspektorientieren Programmierung überzeugt sind.

Die meisten Frameworks verwenden diese Annoations im Zusammenhang mit Build Prozessen bei den der Code auf Annoations hin analysiert wird und die Funktionalität in den generierten Code “kompiliert” wird. Dies wird aufgrund der Performance gemacht und ist bei extremer Verwendung der Annoations auch ratsam.

Ich denke die Verwendung von Annoations ist sehr praktisch um macht den Code frei von unnötigen Ballast. Deshalb verwende ich auch in kleineren Projekten die Annoationsin Zusammenhang mit den neuen PHP5 Reflektion Funktionen.

Mit der Methode ReflectionMethod::getDocComment() lässt sich wunder der PHPDoc Inhalt auslesen.

In diesen Beispiel werden alle öffentlichen Setter Methoden aufgerufen die nicht die Annotation @not_in_session_sync beinhalten.

$oReflectionClass = new ReflectionClass($oValueObjects_ProfilVO);
$aReflectionMethods = $oReflectionClass->getMethods();
foreach($aReflectionMethods as $oReflectionMethod){
   if($oReflectionMethod->isPublic() && !ereg('@not_in_session_sync',$oReflectionMethod->getDocComment())){
      if(preg_match('/^set/',$oReflectionMethod->getName())){
         $oReflectionMethod->invoke($oValueObjects_ProfilVO,uniqid());
     }
  }
}

Wahrscheinlich werden die Annotations Bestandteil der Sprache PHP. Sebastian Bergmann setzt sich dafür ein.