Phpdoc 未找到此文件的摘要

Question

我已经在我们的服务器上安装了 phpDoc，并进行了设置等。它正在正确生成文档。我们使用的是“响应式”模板，但是无论使用什么模板，都会发生此错误。

在“错误”下，扫描的每个文件似乎都有以下错误:

Type        Line    Description
error       0       No summary was found for this file

我已经用谷歌彻底搜索了这个问题，但找不到解决方案。我什至努力追踪消息 PPC:ERR-50000 背后的服务器错误代码，并尝试追踪导致错误的条件，但有点迷失了。

我的问题:

这个错误是什么意思？为什么它在第 0 行，我该如何摆脱它？即使我正确地完成了文档 block ，我可以隐藏这个错误吗？我的无错强制症快要疯了!

非常感谢

编辑一些额外信息:我的每个文件的第 1 行都有以下文档 block :

<?php 
    /**
     * Short Description
     *
     * Long Description
     *
     * @package      Some Package
     * @subpackage   Some Subpackage
     * @category     Some Category
     * @author       F Bloggs <gbloggs@email.com>
     */
?>

Answer 1

但是您的文件顶部是否有两个这样的文档 block ？第一个文档 block 应该是文件本身的文档 block ，第二个文档 block 应该与出现在其后的第一个可记录代码元素配对。

但是，如果文件顶部只有一个文档 block ，它将与找到的第一个代码元素配对，因此“文件本身”似乎缺少其文档 block 。这就是该错误应该指示的内容。