与任何其他编程语言一样，php 支持不同类型的注释。尽管注释会被 php 解释器忽略，但它们对于开发人员体验 (dx) 至关重要。让我们进一步了解 php 中的注释。
php 中的注释类型
php 支持三种类型的注释：
1. 单行注释
单行注释用于注释掉代码中的单行或部分行。您可以使用 // 或 # 来表示单行注释。
示例：
<?php // this is a single-line comment using double slashes. echo "hello, world!"; // this comment is at the end of a line. # this is another way to write a single-line comment using a hash. ?>
2. 多行注释
多行注释，也称为块注释，用于注释掉多行代码。它们以 /* 开头，以 */ 结尾。当您需要暂时禁用大块代码或编写更长的解释时，这种类型的注释非常有用。
立即学习“PHP免费学习笔记（深入）”；
示例：
<?php /* this is a multi-line comment. it can span multiple lines. it is useful for commenting out large sections of code. */ echo "this line will be executed."; ?>
3. 文档注释
文档注释是多行注释的一种特殊形式。它们以 /** 开头，通常用于使用 phpdoc 等工具生成文档。这种类型的注释通常放置在函数、类或方法之上，以描述它们的用途、参数和返回值。
示例：
<?php
/**
* adds two numbers together.
*
* @param int $a the first number.
* @param int $b the second number.
* @return int the sum of the two numbers.
*/
function add($a, $b) {
return $a + $b;
}
echo add(3, 4); // outputs: 7
?>
@param 和 @return 注释提供元数据，文档生成器可以使用这些元数据来生成结构良好且详细的文档。
使用评论的最佳实践
- 保持评论相关且最新：过时的评论可能比没有评论更令人困惑。当您更改代码时，请务必更新您的评论。
- 避免明显的注释：像 $i++ 这样的代码行上方 // increment by 1 之类的注释；是不必要的。注释应该通过解释代码为什么做某事而不是它做了什么来增加价值。
- 对函数和类使用文档注释：这可以帮助您和其他人了解函数或类的作用、它接受哪些参数以及返回什么。
- 使用注释来解释复杂的逻辑：如果您的代码包含复杂的逻辑或算法，请使用注释来分解它并解释您的方法背后的推理。
<?php //====================================================================== // CATEGORY LARGE FONT //====================================================================== //----------------------------------------------------- // Sub-Category Smaller Font //----------------------------------------------------- /* Title Here Notice the First Letters are Capitalized */ # Option 1 # Option 2 # Option 3 /* * This is a detailed explanation * of something that should require * several paragraphs of information. */ // This is a single line quote. ?>
