PHP Standard author header comments

What is the format I should use for PHP header comments?

Is this the same for PEAR as found here

What should be contained?


 * database.php
 * Database access
 * @category   CategoryName
 * @package    PackageName
 * @author     Mike
 * @copyright  2013 Mike
 * @license  PHP License 3.0
 * @version    CVS: $Id:$
 * @link
 * @see        NetOther, Net_Sample::Net_Sample()
 * @since      File available since Release 1.2.0
 * @deprecated File deprecated in Release 2.0.0


Could someone please explain what each of these actually mean other than the author and copyright.

Does entering the version number here do anything other than show the programmer? Can it be used by the system itself?

@package and @category What do these two do? And again, are they used by the system or is it purely for the programmer?


Check out the PHPDoc documentation. It contains explanations of all of the tags.

phpDocumentor 3.0

Leave a Reply

Your email address will not be published. Required fields are marked *