脚本宝典收集整理的这篇文章主要介绍了记录PHP,如果我扩展一个类,我应该复制/粘贴吗?,脚本宝典觉得挺不错的,现在分享给大家,也给大家做个参考。
现在我扩展那个班级.在这个新方法(实现)中,我应该重新记录参数和描述,我应该留空,还是应该只留下适用于该特定实现的相关注释?
我将采用的第一个例子是Zend_Http_Client_Adapter_Interface :: connect,它被声明为:
/** * Connect to the Remote Server * * @param string $host * @param int $port * @param boolean $secure */ public function connect($host,$port = 80,$secure = false);
而且,如果你看一下实现这个接口的类,比如Zend_Http_Client_Adapter_Curl,你会看到:
/** * InITialize curl * * @param string $host * @param int $port * @param boolean $secure * @return void * @throws Zend_Http_Client_Adapter_Exception if unable to connect */ public function connect($host,$secure = false)
所以,复制粘贴的参数;以及实施中的更多信息.
另一个例子是Zend_LOG_Writer_Abstract :: _ write:
/** * Write a message to the log. * * @param array $event log data event * @return void */ abstract PRotected function _write($event);
并且,在子类中,如Zend_Log_Writer_Db:
/** * Write a message to the log. * * @param array $event event data * @return void */ protected function _write($event)
在这里,再次,复制粘贴;父类中的一个小修改,尚未在子类中重新创建.
现在,我一般做什么?
>我一般认为开发人员不经常写评论>并且通常忘记更新它们>所以,我试着让他们的生活更轻松,不要重复评论>除非子类中的注释必须与父类中的注释不同.
以上是脚本宝典为你收集整理的记录PHP,如果我扩展一个类,我应该复制/粘贴吗?全部内容,希望文章能够帮你解决记录PHP,如果我扩展一个类,我应该复制/粘贴吗?所遇到的问题。
本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。