PHP标准作者标题评论

Question

我应该为PHP标题注释使用什么格式？

对于PEAR来说,这是相同的http://pear.php.net/manual/en/standards.header.php吗？

什么应该包含？

<?php

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

?>

有人可以解释除了作者和版权之外,其中每一个实际上是什么意思.

在这里输入版本号是否除了显示程序员之外还做什么？它可以被系统本身使用吗？

@package和@category什么这两个呢？它们是否被系统使用或纯粹是程序员？

Answer 1

查看PHPDoc文档。它包含所有标签的说明。

https://phpdoc.org/docs/latest/index.html

Answer 2

查看 PHPDoc.org @author标签。

句法

@author [name] [<email address>]

例子

 /**
  * @author My Name
  * @author My Name <my.name@example.com>
  */