PHPDOC, questo sconosciuto

Non molti conoscono la potenza di PHPDOC, il linguaggio di documentazione tecnica, derivato da JAVADOC, da utilizzare negli applicativi PHP.

Esso presenta molti costrutti che ci aiutano nell'interpretazione di classi, metodi e funzioni presenti nella nostra codebase:


/**
* Returns the birthday of the user.
*
* @param boolean $asDateTime
* @return string|DateTime
* @throws Exception
*/
public function getBirthdate($asDateTime = false)
{
...


Il PHPDOC è in genere fondamentale quando si lavora in team, e buona pratica anche per il lavoro solitario, per non dover perdere del tempo a demistificare una data scelta di design, sapere quale eccezione può venire lanciata da un metodo e così via.

A parte il vostro fidato IDE, ci sono almeno 3 strumenti per poter generare la documentazione di un progetto PHP mediante PHPDOC:

• phpDocumentor
• doxygen più maturo e supportato Debian-derived apt-get
• docblox PHP 5.3-compliant usato dallo Zend Framework