Benutzer-Werkzeuge
Dies ist eine alte Version des Dokuments!
PHPDoc
Mit PHPDoc können Variablen, Funktionen, Methoden und Klasse im PHP-Quelltext dokumentiert werden. In Entwicklungsumgebungen, wie z. B. PhpStorm, beeinflusst diese Dokumentation den Autovervollständiger, da die IDE auslesen kann, welche Daten von einer Methode als Parameter erwartet werden und von welchem Typ der Rückgabewert ist.
Beispiele:
| Syntax | Beispiel | Beschreibung |
|---|---|---|
| @deprecated Version Beschreibung | @deprecated 1.0 wird durch getCount() abgelöst | Kennzeichnet eine Methode als „veraltet“ |
| @param Typ Variable Beschreibung | @param string $username Benutzername | Definiert den Parameter einer Funktion/Methode |
| @return Typ Beschreibung | @return PDO Datenbankverbindung | Definiert den Rückgabewert einer Funktion/Methode |
| @var Type Variable Beschreibung | @var int Anzahl | Legt den Typ einer Variable fest |
Mögliche Typen
- bool oder boolean
- int oder integer
- mixed
- string
- void
- Namen einer PHP-Klasse (z. B. PDO)
Hinweise: Es ist auch die Angabe von mehreren Typen möglich. Diese werden dann durch einen senkrechten Strich „|“ getrennt. Durch ein nachstehendes [] wird deklariert, dass der vorangestellte Typ innerhalb eines Arrays ausgeliefert wird.
Beispiel:
/** * @param int $groupId Gruppen-ID * @return user[] */
In diesem Beispiel wird von der Funktion die ID einer Gruppe als integer erwartet. Als Rückgabewert wird ein Array mit Objekten der Klasse „user“ zurückgegeben. Dank dieser Dokumentation „weiss“ die Entwicklungsumgebung, dass die Objekte in dem zurückgegebenen Array von der Klasse „user“ sind und stellt die Variablen und Methoden dieser Klasse bei der Autovervollständigung zur Verfügung.
Seiten-Werkzeuge
