Netbeans phpdoc /评论格式

Question

我可以更改这个愚蠢的格式，我看看编辑器/格式中的所有选项，但没有找到任何有用的东西！ 当我刚写了评论块时：

当我在菜单注释块中按SHIFT + ALT + F或Source / Format时崩溃，并且所有phpDoc评论的美丽都被破坏了：（

Answer 1

因为您试图将phpDoc块放在代码中间，所以我相信NetBeans会为您提供 Initial Indentation 和 Continuation Indentation 的组合（在工具|选项|编辑器|格式化语言= PHP和类别=制表符和缩进）。

真正的问题是在代码流程中找不到docblock注释。看看documentable elements上的phpDocumentor手册页。 Docblock注释需要进入非常具体的位置，例如，在函数之前，类定义之前，在define语句之前等等。

在你的情况下，假设try-catch块在一个函数内，那么@todo将进入函数之前出现的docblock。

或者，您可以切换到“单行”评论样式，例如

// @todo - Fix something with the next line

但是这不会在phpDoc中被提取。 （事实上​​，在代码流中使用docblock的示例中，我不太确定phpDocumentor会选择它。）此外，它将从try语句中缩进至少一个级别，因为它出现在街区内。