假设以下片段: public function foo() { return $this->dependency->bar(); } 如果已知dependency :: bar()抛出异常,但不希望foo()处理它. foo()在docblock中有@throws条目吗?或者这是隐含的吗? phpdoc文档对此有些模糊. 假设依赖性是基于接口注入的;应该接口文档该方法可以抛
我有一个带有方法的PHP类.在基类中(它更像是原型,但我不使用原型,因为我们必须向后兼容),我记录了方法的参数和描述. 现在我扩展那个班级.在这个新方法(实现)中,我应该重新记录参数和描述,我应该留空,还是应该只留下适用于该特定实现的相关注释? 我的目标是拥有由PhpDoc生成的可读AP
我已经切换到PHP 5.3和名称空间.看起来@package标签现在是冗余且无用的. 是否仍然需要phpDoc,或者我现在可以忽略此标记吗? 谢谢解决方法:这不是必需的. 最新文档现在指出,如果您使用命名空间并且您不需要不同的文档结构,则应避免使用@package: If, across the board, both logical
我最近创建了一个用于创建HTML元素的类.我没有为每个现有的HTML元素和属性创建方法而烦恼,而是决定使用魔术方法__get和__call.所以使用我的代码我基本上可以这样做: $signUpForm->insert->input->type('text')->name('firstName')->maxlength(100)->disabled $signUpForm->insert-
我在ZF1的评论/文档中找到了一些特殊符号“#@”和“#@ – ”.例: /**#@+ * @access protected */ (https://github.com/zendframework/zf1/blob/master/library/Zend/Mail.php#L54) 我之前在另一个不同的存储库中看到过. 这些是什么意思?解决方法:它们是PHP DocBlock模板声明.文
请考虑以下代码,我试图仅解析文件中的第一个phpDoc样式注释(不使用任何其他库)(文件内容放在$data变量中用于测试目的): $data = " /** * @file A lot of info about this file * Could even continue on the next line * @author me@example.com * @version 2010
我想知道是否可以使用phpdoc来定义特定范围内的某个对象(仅在方法内)作为PHPUni的Mock,所以在该方法中我可以利用类型提示,例如 – > expected, – >方法等等,就像刚刚创建模拟而不将其解析为真正的类一样. 这是一个示范: class someTest extends PHPUnit { // here, usually w
我正在研究基于phpdoc生成文档的不同解决方案,Doxygen看起来很棒,但到目前为止搜索受到严重限制. 例如,我搜索字符串“session”,它给了我2个结果: > sessionExists Lib_Session > sessionMatchesIp Lib_Session 同一个类也有一个名为getSession的方法,我似乎无法找到它.不仅如此,类