假设以下片段:
public function foo()
{
return $this->dependency->bar();
}
如果已知dependency :: bar()抛出异常,但不希望foo()处理它. foo()在docblock中有@throws条目吗?或者这是隐含的吗? phpdoc文档对此有些模糊.
假设依赖性是基于接口注入的;应该接口文档该方法可以抛出指定的异常.
如果异常应该由调用代码处理还是与情况无关,这是否重要?
一直是语义学:)
解决方法:
你已经创建了公共函数(每个人都可以使用它),在某些情况下可以抛出异常 – 因此你必须在你的docblock中有@throws条目.
如果从您的依赖项中抛出异常 – 它是您的内部实现并且它被封装 – 因此将使用您的函数的人将不知道您的函数的期望.
在接口注入的情况下 – 接口必须描述所有异常,因为异常它是类和接口行为的一部分必须描述所有可能的行为.
如果你有try-catch块并处理来自依赖项的所有异常 – 你必须在docblock中的@throws条目中只有你自己的异常.
标签:php,phpdoc 来源: https://codeday.me/bug/20190701/1348717.html
本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享; 2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关; 3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关; 4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除; 5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。