草庐IT

php - Eclipse PDT 能否自动将 PHPDoc block 添加到需要的代码中?

我知道大多数用于Eclipse的Java开发工具都有一个快捷脚本,用于为所需元素(包括页面级)添加JavaDocblock。此外,我知道PDT将允许您通过源菜单为许多东西“生成元素注释”。是否有Eclipse插件(或者它可能是PDT中的标准,我只是错过了它)允许您为给定文件中的所有/某些受支持元素添加PHPDocblock? 最佳答案 将你的文本光标放在你的函数、类或其他任何东西的正上方,输入/**并按回车键,您将开始编写PHPDoc。例如。/****Enterdescriptionhere...*@paramunknown_typ

php - 使用 Doxygen 或 PHPDoc 记录获取/发布参数

关闭。这个问题需要更多focused.它目前不接受答案。想改进这个问题吗?更新问题,使其只关注一个问题editingthispost.关闭4年前。Improvethisquestion我正在查看PHPDoc的文档,但找不到一个好的方法来记录我发送到各种方法的Post变量。因此,我开始研究Doxygen,希望它能为我提供一种更好的方法来记录所有这些变量。我的代码涉及到很多AJAX请求,所以大部分变量都是通过post发送的。有什么好的方法可以让我记录doxygen中的post变量吗?我无法确定仅使用标准参数标签运行时是否会出现错误。如果没有,是否有其他记录员可能会在此过程中提供帮助?还是我

用于接口(interface)和实现接口(interface)的类的 PhpDoc - 区别

关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭4年前。社区在13天前审查了是否重新打开此问题并使其关闭:原始关闭原因未解决Improvethisquestion问题很简单——我应该如何区分phpdoc的接口(interface)和类实现接口(interface)?它们应该/可以相同,还是接口(interface)文档应该尽可能通用,而实现此接口(interface)的类更具体?我从我的真实代码中包含一个方法phpDoc:我的界面:interfaceCacheInterface{/

PHPDoc:嵌套数组中的类型提示(例如 2 维)

是否有正确的方法来记录另一个维度内的数组中的值/对象?通常一个数组会这样处理:/**@varClassName[]$Array*/$Array=array($InstanceOfClassName,..)但是我需要这样的东西:/**@varClassName[][]$Array*/$Array=array(0=>array($InstanceOfClassName,..))这显然是行不通的,那么正确的PHPDoc表示法是什么? 最佳答案 PhpStorm允许使用双括号[][]键入提示嵌套数组:/**@var\SplFileInfo[

可变长度参数数组的 PHPDoc

是否有用于记录采用单个配置数组而不是单个参数的函数的语法?我正在特别考虑CodeIgniter风格的库,它们使用与此类似的机制:$value){$this->$key=$value;}}}////Libraryusage:////Iniitializeourconfigurationparameters$config['foo']='test';$config['bar']=4;$config['baz']=array('x','y','z');$x=newMyLibrary($config);?>所以我的问题是,是否有一些受支持的方式来记录配置数组,而不仅仅是纯文本描述?实际指定一个

php/phpDoc - @return $这个类的实例?

如何在我的phpDoc中将方法标记为“返回当前类的实例”?在下面的示例中,我的IDE(Netbeans)将看到setSomething总是返回一个foo对象。但如果我扩展该对象,则情况并非如此-它将返回$this,在第二个示例中是bar对象而不是foo对象。classfoo{protected$_value=null;/***Setsomething**@paramstring$valuethevalue*@returnfoo*/publicfunctionsetSomething($value){$this->_value=$value;return$this;}}$foo=newf

php - PHPdoc @param 中的两种或多种数据类型

好的,我的类方法上面确实有这个phpdoc/***thisafunctionthattranslatesthetext*@paramstring|boolean$langifstringthestringgivenintheparameterwillbethelanguagecodethatwillrepresentthelanguagedesired,iftrue,thiswilltranslatebasedonthewebsite'scurrentlanguage,iffalsewillnottranslate.*/现在我的问题是,如何定义只能接受字符串和bool值的$lang数据

php - 在 phpdoc 中保存函数顺序

我在我的项目上运行phpdoc并且有一个文件(唯一有意义的文件),其中方法的顺序对于分组方法很重要。如何在生成的文档中使用与源文件中相同的函数顺序?实际上,如果有帮助,我准备更改文档框架。 最佳答案 不幸的是,似乎没有办法告诉文档编写者列出方法的顺序。但是,@see可能对您提请注意相关功能很有用。再加上关于所需订单的完整描述中的注释,或者一些无序的异常可能是该工具目前可以提供的最好的。 关于php-在phpdoc中保存函数顺序,我们在StackOverflow上找到一个类似的问题:

PHPdoc - 为 stdClass 对象定义对象属性

我正在尝试弄清楚是否可以使用PHPdoc来定义由函数或对象方法返回的对象属性。假设我有以下类(class):classSomeClass{publicfunctionstaffDetails($id){$object=newstdClass();$object->type="person";$object->name="dave";$object->age="46";return$object;}}现在,很容易定义输入参数。/***GetStaffMemberDetails**@paramstring$idstaffidnumber**@returnobject*/classSomeC

php - PHPDoc 中的闭包语法

我在PHPDoc中找不到任何关于闭包类型的文档。所以我的问题是如何定义发送到闭包的参数的参数及其返回值?例子:我如何描述“回调”将获得一个“MyCustomClass”、一个数字和一个字符串,并返回一个“MyOtherCustomClass”?/***@paramMyCustomClass$cls*@paramClosure$callbackthisisn'treallyexplainingwhatthisis**@returnMyOtherCustomClass*/functionchanger($cls,$callback){return$callback($cls,2,"astr