phpDocumentor 注释语法详解
PHPDocumentor是强大的代码注释生成器,本文对各个参数进行了简单地的总结:
@abstract
-------------
使用@abstract标记来声明一个方法,类变量或类必须重新定义子类中是有效的。
@abstract
-------------
使用@abstract标记来声明一个方法,类变量或类是抽象的。
一个类中,只要有一个抽象方法,这个类必须被声明为抽象类。
抽象方法在子类中必须被重写。
抽象类在被继承后,其中的抽象方法不能被重写。
@access
-------------
访问权限public、protected、private
@author
-------------
作者
@category
-------------
分类,例如(library,helper,view等)
@copyright
-------------
版权
@deprecated
-------------
过时的,即将被弃用
@example
-------------
包括带有语法高亮的外部示例文件
@final
-------------
final类不能被继承,final方法不能被重写
@filesource
-------------
创建包含当前文件和链接的,语法高亮显示的参照文件源代码
@global
-------------
全局变量
@ignore
-------------
使用@ignore防止文档记录的元素,如重复的元素。
@internal
-------------
标记为私有,软件项目内部的
@license
-------------
指向许可文件的超链接
@link
-------------
超链接
@method
-------------
一个类的“魔术”方法
@name
-------------
phpDocumentor识别global变量中的@name标记(结合@global),用它来重命名一个文档的global变量以增强可读性。一个global变量必须以($)开始,否则phpDocumentor会忽略此标记并报错。
@package
-------------
指定包来组织类或方法。@package只能用于文档程序页面或类。
@param
-------------
函数的参数
@property
-------------
“魔术”属性
@return
-------------
指定一个函数或方法的返回值类型
@see
-------------
指向元素的文档的链接
@since
-------------
从哪个版本开始将其添加进package
@static
-------------
静态属性或方法,无需实例化即可调用
@staticvar
-------------
函数或方法中的静态变量
@subpackage
-------------
和@package一起为文档组织php文件
@todo
-------------
未来可能有变动
@tutorial
-------------
显示一个指向该文件的教程
@uses
-------------
显示指向元素的文档的链接,并创建一个反向链接在其他元素的文档
@var
-------------
变量
@version
-------------
版本
phpDocumentor 注释语法详解的更多相关文章
- Velocity魔法堂系列二:VTL语法详解
一.前言 Velocity作为历史悠久的模板引擎不单单可以替代JSP作为Java Web的服务端网页模板引擎,而且可以作为普通文本的模板引擎来增强服务端程序文本处理能力.而且Velocity被移植到不 ...
- Hadoop Hive sql语法详解
Hadoop Hive sql语法详解 Hive 是基于Hadoop 构建的一套数据仓库分析系统,它提供了丰富的SQL查询方式来分析存储在Hadoop 分布式文件系统中的数据,可以将结构 化的数据文件 ...
- Markdown语法详解-cnblog
博客的重要性 博客,英文名为Blog,它的正式名称为网络日记. 为什么要写博客? 需要总结和思考.有时候我们一直在赶路,却忘了放慢脚步 提升文笔组织能力 提升学习总结能力 提升逻辑思维能力 帮助他人, ...
- Hive笔记--sql语法详解及JavaAPI
Hive SQL 语法详解:http://blog.csdn.net/hguisu/article/details/7256833Hive SQL 学习笔记(常用):http://blog.sina. ...
- Thymeleaf3语法详解和实战
Thymeleaf3语法详解 Thymeleaf是Spring boot推荐使用的模版引擎,除此之外常见的还有Freemarker和Jsp.Jsp应该是我们最早接触的模版引擎.而Freemarker工 ...
- Xpath语法详解
1.简介 XPath是一门在XML和HTML文档中查找信息的语言,可以用来在XML和HTML文档中对元素和属性进行遍历 XPath的安装 Chrome插件XPath Helper 点Chrome浏览器 ...
- mysql用户授权、数据库权限管理、sql语法详解
mysql用户授权.数据库权限管理.sql语法详解 —— NiceCui 某个数据库所有的权限 ALL 后面+ PRIVILEGES SQL 某个数据库 特定的权限SQL mysql 授权语法 SQL ...
- Java8的Stream语法详解(转载)
1. Stream初体验 我们先来看看Java里面是怎么定义Stream的: A sequence of elements supporting sequential and parallel agg ...
- [持续交付实践] pipeline使用:语法详解
一.引言 jenkins pipeline语法的发展如此之快用日新月异来形容也不为过,而目前国内对jenkins pipeline关注的人还非常少,相关的文章更是稀少,唯一看到w3c有篇相关的估计是直 ...
随机推荐
- GitHub 在 Clion2016.1.3 中的设置
1.在 GitHub 上注册,建立一个 Repositories,结果获得如下 https://github.com/GPerelman/Clion2016.1.3.git 2.打开 git-bash ...
- AssetBundle in Unity 5.0
http://forum.unity3d.com/threads/new-assetbundle-build-system-in-unity-5-0.293975/
- winform的扩展的带有截图功能picturebox
using System; using System.ComponentModel; using System.Diagnostics; using System.Drawing; using Sys ...
- docker和shipyard使用问题
http://blog.csdn.net/cuisongliu/article/details/49178461 Docker启动如果随服务一起启动? docker run -ti -d --rest ...
- mssql注入
<%@ Page Language="C#" AutoEventWireup="true" %> <%@ Import Namespace=& ...
- Java并发编程核心方法与框架-phaser的使用
arriveAndAwaitAdvance()方法 arriveAndAwaitAdvance()作用是当前线程已经到达屏障,在此等待一段时间,等条件满足后继续向下一个屏障执行. public cla ...
- 经纬度距离计算Java实现代码
public class test { private static double rad(double d) { return d * Math.PI / 180.0; } public stati ...
- asp.net mvc 4 高级编程学习笔记:第三章 视图(2)
页面布局 asp.net MVC中提供了布局的支持,默认情况下才布局文件保存到 /View/Shared/目录下的_Layout.cshtml,View目录有个_ViewStart.cshtml文件, ...
- android自定义控件(6)-详解在onMeasure()方法中如何测量一个控件尺寸
今天的任务就是详细研究一下protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec)方法.如果只是说要重写什么方法有什么 ...
- [asp.net core]project.json(2)
摘要 上篇文章介绍了project.json中的一部分属性.属性真的比较多,所以分开了,考虑到其中的英文比较简单,也不再进行翻译了,从英文原文中,直接粘贴过来了. project.json(1) pr ...