PHPのネストされたマルチラインコメントの危険

PHPは、ネストされたマルチラインコメントをサポートせず、それらをネストしようとすると、予期しないコード実行または解析エラーが発生する可能性があります。最初の /コメントブロック全体を閉じるため、コメントをコメントする予定であっても、それに続くコードは実行され、機能が不注意に再宣言されたときにバグまたは致命的なエラーにつながります。これを回避するには、//コメント、IDEブロックのコメント、または既存のコメントを含むコードをコメントするときのIF（0）{}でコードを使用するか、コメントを使用してください。 p>

PHPでマルチラインコメントをネストすることはできません。そうしようとすると、微妙で捕獲が困難なバグにつながる可能性があります。これはマイナーな言語の癖のように思えるかもしれませんが、特にデバッグやリファクタリング中に大きなコードブロックをコメントするときは、それは本当の落とし穴です。

PHPは/* */のみをマルチラインコメントデリミターとして認識し、最初の*/ /*ブロック全体を閉じます。これは、ネスティングが他の言語やプログラミングコンストラクトに期待されるように機能しないことを意味します。

あなたが巣を作ろうとするとどうなりますか？

一見無害なコードを考えてみましょう：

 /*
    いくつかの重要な機能
    /*
        これはネストされたコメントです
    */
    まだ私がコメントだと思ったものの中
*/
エコー「こんにちは、世界！」;

echoステートメントを含め、ブロック全体がコメントアウトされると予想される場合があります。しかし、これが実際に起こることです：

• 最初の/*コメントを開始します。
• 最初の*/ （「ネストされたコメント」の後）はコメントを終了します。
• その後のすべてのすべて - Still inside...とechoを含む - は、PHPコードとして実行されます。

そのため、「コメントアウト」 echoが実行され、出力が得られます。さらに悪いことに、未熟な*/の後にPHP構文が無効または不完全な場合、デバッグと混乱する解析エラーが表示されます。

これが実際に危険な理由

最大のリスクは理論的ではありません。開発者が/* ... */一時的にコードのチャンクを無効にするときです。

デバッグ中にこのシナリオを想像してください：

 /*
関数ProcessUserData（$ data）{
    / *入力を検証 */
    if（！isvalid（$ data））{
        logerror（ "無効なデータ"）;
        falseを返します。
    }
    Performaction（$ data）;
}
*/

安全だよね？ただし、内側のコメント（ /* Validate input */ ）にはA */が含まれており、外部コメントを早期に終了します。結果？

• function processUserData(...)はもはやコメントアウトされていません。
• このファイルが含まれているか実行されている場合、関数が定義されます。おそらく、競合または意図しない動作を引き起こします。
• さらに悪いことに、関数が既に存在する場合、致命的な「補償できない」エラーが得られます。

この種の間違いは特に危険です。

• PHPからの警告はありません。
• 構文の蛍光ペンは、それを捕まえることができず、そうでないときにすべてを「コメントした」と着色することがあります。
• エラーは実際の原因からはほど遠いように見える場合があります。

より安全な代替品

/* */に依存する代わりに、これらのより安全なアプローチを使用してください。

• 複数の行のコメントを使用する（ // ）
  特に一時的なデバッグの場合：

   //関数ProcessUserData（$ data）{
  // if（！isvalid（$ data））{
  // logerror（ "無効なデータ"）;
  // falseを返します。
  //}
  // performaction（$ data）;
  //}

• IDEブロックコメントを使用します
  ほとんどの編集者では、ショートカットで各行でコードとトグル//を選択できます。速くて安全です。

• シェルスタイルのコメントに#を使用してください
  //と同じ動作がありますが、視覚的な区別を好む人もいます。

• 大きなブロックについては、 if (0) { ... }のラッピングを検討してください
  例：

   if（0）{
      関数ProcessUserData（$ data）{
          / *入力を検証 */
          if（！isvalid（$ data））{
              logerror（ "無効なデータ"）;
              falseを返します。
          }
          Performaction（$ data）;
      }
  }

  これにより、コードが解析されます（構文エラーはまだキャッチされています）が、実行されません。

  結論

  PHPのマルチラインコメントは、ネストをサポートしていません - フルストップ。既存の/* */コメントを含むコードをコメントするために彼らに頼ることは、トラブルを求めています。パーサーはインデントや意図を気にしません。最初の*/で停止します。

  修正？開発中にコードをコメントするには/* */を避けてください。 //に固執するか、条件付きブロックを使用します。それは大きな頭痛を防ぐ小さな習慣の変化です。

  基本的に： /*または*/を含むコードをコメントしている場合、それが壊れると仮定します。それに応じて計画します。

  以上がPHPのネストされたマルチラインコメントの危険の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。