| 标示 | 作用 | | --- | --- | | access | 该标记用于指明关键字的存取全权限。 可以是：private，public，proteced。 使用范围：class，function，var，define，module。 | | author | 指明作者。 | | copyright | 指明版权信息。 | | const | 指明PHP中的define的常量。 使用范围：define。 | | final | 指明关键字是一个最终的类、方法、属性，禁止派生，修改。 使用范围：class，function，var。 | | global | 指明在此函数中引用的全局变量。 | | name | 为关键字指明一个别名。 | | package | 用于逻辑上将一个或几个关键字分到一组。 | | abstract | 说明当前累是一个抽象类。 | | param | 指明一个函数的参数。 | | return | 指明一个函数的返回值。 | | static | 指明关键字是静态的。 | | var | 指明变量类型。 | | version | 指明版本信息。 | | todo | 指明应该改进或者没有实现的地方。 | | link | 可以通过link指到文档中的任何一个关键字。 | | ignore | 用于在文档中忽略制定的关键字。 | >[info]PHP注释有三种语法： ~~~php // 这样事单行注释 # 这样也是单行注释，但是很多教程里并没有说这种方式 /* * 这样是多行注释 */ ~~~ ~~~ /** * XXXXX的文件 * * 功能1： xxx * 功能2： xxx * * @file * @package core * @author Joy <author@yunzhongkan.com> * @version $Id: php开发注释规范.txt,v 1.1 2014/03/04 20:37:46 Joy Exp $ * @link http://www.yunzhongkan.com */ ~~~ ~~~ /** * Class 类名 * @package 命名空间 * 等等 */ ~~~ ~~~ /** * 函数的含义说明 * * @access public * @param mixed $arg1 参数一的说明 * @param mixed $arg2 参数二的说明 * @param mixed $mixed 这是一个混合类型 * @return array 返回类型 */ ~~~