今天在编写PHPDoc的导出文档的时候发现一个很郁闷的错误,虽然这个warning不是什么重要错误,但是看着总是很不爽的。于是就去网上找了很多相关的资料,可是郁闷的是不知道是我用的PHPDoc版本太新(1.4的版本),还是说很多人都没遇到这个问题,反正就是没有相关的这个资料找到,只是找到了一些从PHPDocumentor官方网倒出来的关于@package的使用注意事项,然后就只能一条一条检查,看了一个版本又一个版本,总算是被我解决了。
而且发现该方案可以解决@package之类相关的错误提示: 出现的问题:
1、no @package tag was used in a DocBlock for XXXXXXXXXXX
2、XXXXXX has no page-level DocBlock, use @package in the first DocBlock to create one
3、ERROR: XXXX can not have @package tag。。。。(具体的提示我忘记了,大题的意思是这里的文档不能使用@package标签)
出现上诉问题的主要原因是:页面级的文档块注释解析错误
页面级文档注释:
必须是文件中的第一个文档块注释,并且有@package标签
该文档快注释之后如果是紧接着一段PHP代码或是class类申明,必须用文档块注释隔开(也就是说页面级文档块注释之后不能紧接着代码片段) 比如情况:
案例一:
[U]复制代码[/U] 代码如下:
/**
* 这个是一个页面级文档块注释
*@package haha
*
*/
class test {
}
以上的情况就会出现上述2的错误信息
解决该案例的方案是给class重新声明一个文档块注释
[U]复制代码[/U] 代码如下:
/**
* 这个是一个页面级文档块注释
*@package haha
*
*/
/**
* 我是test类
*/
class test {
}
***********************************************
案例二:
[U]复制代码[/U] 代码如下:
/**
* 这个是一个页面级文档块注释
*/
/**
* 这个是一个页面级文档块注释
*@package haha
*
*/
class test {