PHP程序写大量注释好吗？

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

回复讨论(解决方案)

存了占点 可以忽略的磁盘外 运行 会被无视的

写代码注释要写关键点，有些明显的程序一看就会懂的，就不需要写的，写的话，反而看起来累赘。

编程中注释是一个非常重要的环节。 当然一眼能看懂的 就跟楼上说的那样。 注释是为了以后方便维护，不会影响运行速度的。

大段的注释不会影响程序的执行效率

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

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

通常代码块不宜过大，以不超过三个视觉跨度为宜（百行以内，编辑器中翻屏两三次）
过多的行间注释，势必会影响阅读者对算法的理解（看到后面忘了前面）

撸主的注释语言很有意思，不过感觉有点罗嗦了，个人认为还是简洁些为好，‘我们’俩字也太多了吧

注释多是好事，但显然lz的注释不是多而是?嗦了。。语句要简单扼要才好 :)

php的注释到没所谓，html的注释是占流量的，看上去虽然很微小～

代码注释量在20%-30%之间为宜，不要用带感情色彩的文字。

//核心功能，没有投票的可以投//投票成功：1.本投票表对应行记录增加一票 2.投票记录表增加该用户的投票记录，投票次数不能大于1。 $voteid=$_GET["voteid"];//获得ID，检测其是否投过票 $nowip=$_SERVER["REMOTE_ADDR"];$today=date("Ymd");  //是否存在记录$where="ip='$nowip' and votedate='$today'";$record=new Record();$res=$record->fetchAll($where)->toArray();if(count($res) > 10){$this->view->res="您今天已经投过票了";$this->render("res");}else{ //可以投票$recordarr=array("ip"=>$nowip,"votedate"=>$today,"voteid"=>$voteid);  //增加一条记录,如果添加成功返回添加成功的id值$insertres=$record->insert($recordarr);if($insertres){//增加该用户投的对应的一票，操作vote表$vote=new Vote();

等号两边加个空格吧。

好啊，写了别人看的也清楚，自己也能回想

我觉不需要太过注意，适量就好。就像吃饭一样，吃多了对胃不好，吃少了就别活了。

适量就好！！！

哥们，注释简明扼要就好，打中文也挺累的吧？你里面很多一长段话都可以缩略成几个关键词。

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

关键的地方写上注释就可以了哦，不用那么?嗦的

注释不要超过代码就行了，自己给自己看的就看着办吧，要是给别人看的那么就机械点

注释的口气有点像老师在教小学生