PHP程序写大量注释好吗?该如何解决

WBOY
发布: 2016-06-13 12:10:47
原创
1251 人浏览过

PHP程序写大量注释好吗?
我写php代码有大量注释,会不会有什么对php运行性能有不好的影响啊?
注释多的很,有时间比代码本身还多。有没有什么弊端?


如:

//这个是投票的核心功能区,只要该用户今天没有投票就可以投票<br />//投票成功:1.本投票表对应行记录增加一票 2.投票记录表增加该用户的投票记录,防止他今天再投。<br /><br />$voteid=$_GET["voteid"];<br /><br />//拿到id了,但是我们不是直接就给这个id添加一票。我们要先看看,这个ip今天是否已经投过票了。<br /><br />//有了ip黑名单功能,我们应该在最先核实该用户是否已经进入我们的黑名单了,如果进了黑名单,后面的所有都不用走了。<br /><br /><br /><br /><br /><br />//我们先拿到这个朋友的ip。<br />$nowip=$_SERVER["REMOTE_ADDR"];<br />$today=date("Ymd");<br /><br /><br />//然后去我们ip记录表查询今天这个ip是否有记录<br />$where="ip='$nowip' and votedate='$today'";<br /><br />//下面我们查询记录表,看看有没有相关记录<br />$record=new Record();<br />$res=$record->fetchAll($where)->toArray();<br />if(count($res) > 10){<br />$this->view->res="您今天已经投过票了";<br />$this->render("res");<br />}else{<br /><br />//如果进到这里,说明这个ip是可以投票的,我们先增加他的ip信息,再增加一个票数<br /><br />$recordarr=array(<br />"ip"=>$nowip,<br />"votedate"=>$today,<br />"voteid"=>$voteid<br />);<br /><br /><br />//增加一条记录,如果添加成功返回添加成功的id值<br />$insertres=$record->insert($recordarr);<br />if($insertres){<br />//如果进来,说明添加记录成功,那么我们就直接增加该用户投的对应的一票,下面我们又要操作vote表<br />$vote=new Vote();
登录后复制

------解决思路----------------------
存了占点 可以忽略的磁盘外 运行 会被无视的
------解决思路----------------------
写代码注释要写关键点,有些明显的程序一看就会懂的,就不需要写的,写的话,反而看起来累赘。
------解决思路----------------------
编程中注释是一个非常重要的环节。 当然一眼能看懂的 就跟楼上说的那样。 注释是为了以后方便维护,不会影响运行速度的。
------解决思路----------------------
大段的注释不会影响程序的执行效率

注释分为两类
1、工作流程描述,说明“做什么”
2、算法实现描述,说明“怎么做”

通常 工作流程描述 宜放在程序文件的开始处
算法实现描述 随代码紧要处出现

通常代码块不宜过大,以不超过三个视觉跨度为宜(百行以内,编辑器中翻屏两三次)
过多的行间注释,势必会影响阅读者对算法的理解(看到后面忘了前面)
------解决思路----------------------
撸主的注释语言很有意思,不过感觉有点罗嗦了,个人认为还是简洁些为好,‘我们’俩字也太多了吧
------解决思路----------------------
注释多是好事,但显然lz的注释不是多而是啰嗦了。。语句要简单扼要才好 :)
------解决思路----------------------
php的注释到没所谓,html的注释是占流量的,看上去虽然很微小~
------解决思路----------------------
代码注释量在20%-30%之间为宜,不要用带感情色彩的文字。
<br />//核心功能,没有投票的可以投<br />//投票成功:1.本投票表对应行记录增加一票 2.投票记录表增加该用户的投票记录,投票次数不能大于1。<br /> <br />$voteid=$_GET["voteid"];<br />//获得ID,检测其是否投过票 <br /><br />$nowip=$_SERVER["REMOTE_ADDR"];<br />$today=date("Ymd");<br /> <br /> <br />//是否存在记录<br />$where="ip='$nowip' and votedate='$today'";<br />$record=new Record();<br />$res=$record->fetchAll($where)->toArray();<br />if(count($res) > 10){<br />$this->view->res="您今天已经投过票了";<br />$this->render("res");<br />}else{<br /> <br />//可以投票<br />$recordarr=array(<br />"ip"=>$nowip,<br />"votedate"=>$today,<br />"voteid"=>$voteid<br />);<br /> <br /> <br />//增加一条记录,如果添加成功返回添加成功的id值<br />$insertres=$record->insert($recordarr);<br />if($insertres){<br />//增加该用户投的对应的一票,操作vote表<br />$vote=new Vote();<br />
登录后复制



------解决思路----------------------
等号两边加个空格吧。

------解决思路----------------------
好啊,写了别人看的也清楚,自己也能回想
------解决思路----------------------
我觉不需要太过注意,适量就好。就像吃饭一样,吃多了对胃不好,吃少了就别活了。

适量就好!!!
------解决思路----------------------
哥们,注释简明扼要就好,打中文也挺累的吧?你里面很多一长段话都可以缩略成几个关键词。

<br />/**<br /> * 投票核心处理部分<br /> * 说明:每IP用户每日限制投一票。<br /> * 流程:投票->判断该ip是否在黑名单->【是】中断并提示信息->判断该IP今日是否投票->【是】提示信息;【否】记录ip投票信息,记录投票内容<br /> */<br /><br />$voteid=$_GET["voteid"];<br /><br />//ip<br />$nowip=$_SERVER["REMOTE_ADDR"];<br />$today=date("Ymd");<br /><br />//检查Ip今日是否投票<br />$where="ip='$nowip'?and?votedate='$today'";<br />$record=new?Record();<br />$res=$record->fetchAll($where)->toArray();<br />if(count($res)?>?10){<br />$this->view->res="您今天已经投过票了";<br />$this->render("res");<br />}else{<br />?<br />//记录已投票ip<br />$recordarr=array(<br />"ip"=>$nowip,<br />"votedate"=>$today,<br />"voteid"=>$voteid<br />);<br />$insertres=$record->insert($recordarr);<br /><br />//成功记录ip则记录投票内容<br />if($insertres){<br />//操作vote表<br />$vote=new?Vote();
登录后复制

------解决思路----------------------
关键的地方写上注释就可以了哦,不用那么啰嗦的
------解决思路----------------------
注释不要超过代码就行了,自己给自己看的就看着办吧,要是给别人看的那么就机械点

相关标签:
来源:php.cn
本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板