PHPプログラムにコメントをたくさん書くのは良いことなのでしょうか？

大量のコメントを含む PHP コードを作成すると、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();

ディスカッションへの返信(解決策)

保存されたポイントは無視でき、ディスク外での実行は無視されます

コードのコメントを書くときは、重要なポイントを書く必要があります。当たり前の手順 読めばわかるなら書かなくてもいいです 書いてしまうと面倒に見えます。

コメントはプログラミングの非常に重要な部分です。もちろん、上で述べたように、一目で理解できます。注釈は将来のメンテナンスを容易にするためのものであり、実行速度には影響しません。

コメントの大きな段落はプログラムの実行効率には影響しません

コメントは 2 つのカテゴリに分類されます
1. 「何をするか」を説明するワークフローの説明
2. 「どのように行うか」を説明するアルゴリズム実装の説明

通常、ワークフローの説明はプログラム ファイルの先頭に配置する必要があります
アルゴリズム実装の説明は、コードの重要なポイントとともに表示されます

通常、コード ブロックは大きすぎてはならず、ビジュアル スパンが 3 つ以下である必要があります (
パス 行間のコメントが多すぎると、必然的に読者のアルゴリズムの理解に影響を及ぼします (読んだ後、前の部分を忘れてしまいます)

Luzhu のコメント言語は非常に興味深いですが、個人的には、もっと簡潔にしたほうがいいと思います。「We 」は言葉が多すぎます

コメントが増えるのは良いことですが、明らかに 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();

重要な場所にコメントを書くだけです。冗長にする必要はありません

コメントはコードを超えてはなりません。他の人に見せたい場合は、それ以上にしてください。機械的

コメントの口調はちょっと小学生に教える先生みたい