如何为方法和属性自定义 NetBeans PHP auto DocBlock？

php netbeans documentation docblocks

2022-08-30 13:42:51

在我创建了一个方法来生成DocBlock之后。它会自动填充该函数的和。例：/**<enter>@param@return

/**
 *
 * @param type $str
 * @return type 
 */
public function strlen($str){
    return strlen($str);
}

我如何自定义正在生成的块，以便它也填充并最终在之后@author/**<enter>

/**
 *
 * @param type $str
 * @return type 
 * @author John Doe <john@doe.com>
 */
public function strlen($str){
    return strlen($str);
}

谢谢

答案 1

可能有更好的方法来做到这一点，但这是我使用过的：在“工具>选项”下，>编辑器>代码模板，有一些预定义的组合可以快速生成代码。7.0 中的默认模板之一是：

vdoc<tab>

这将生成伪文档块和变量定义。您可以替换它并添加新的文本，这些文本可以扩展到您想要的任何文本中，就像vim缩写一样。您可以在 Netbeans 文档站点上找到有关此内容的更多信息：

答案 2

我相信你正在寻找的答案会在这里找到：phpDocumentor Tutorial

我想你会想看看 --customtags 命令行开关。

因此，最有可能的是，当您转到工具->选项->“PHP”->“PHPDoc”时，您可以将该--customtags命令行开关添加到PHPDoc脚本行中。

我个人没有尝试过，但我一直在考虑将NetBeans与DocBlocks和PHPDocumentor结合使用的想法，以“自动”创建大量可用的文档，而不会对其他编码人员造成太大的麻烦。;-)

这里有一个关于设置NetBeans与PHPDocumentor一起使用的很好的视频教程：使用NetBeans IDE 7.0生成PHP文档