我正在尝试了解 phpDocumentor。我通常为每个文件放一个类。我是否被迫记录文件和类(class)？我只想记录类(我为什么要记录文件？)但我收到警告...
WARNING in comment.class.php on line 8: DocBlock would be page-level, but precedes class "Comment", use another DocBlock to document the file
谢谢
最佳答案
您不必记录文件，它只是一个警告。如果您不放置文件级文档，那么 phpdoc"file"列表中将没有信息，即使“类”列表中会有一些信息。
关于php文档: document only classes，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/3906846/