PHP 简明教程

PHP 注释

1. PHP 中的注释

PHP 注释不会作为代码的一部分被执行。它们存在的唯一目的,是让任何阅读代码的人能够更好地理解代码逻辑。

PHP 注释主要用于以下场景:

  • 让其他人理解你的代码
  • 提醒自己曾做过的工作 - 大多数程序员都经历过这样的情况:一两年后重新审视自己写的代码,却不得不花时间重新弄清楚当时的设计思路。
  • 暂时屏蔽部分代码 - 常用于代码测试与调试阶段。

PHP 支持两种类型的注释:

  • 单行注释
  • 多行注释

语法示例:

// 这是一个单行注释
# 这也是一个单行注释
/* 这是一个多行注释 */

2. PHP 单行注释

单行注释以 //# 开头。

//# 之后直到该行结束的所有文本,都将被 PHP 解析器忽略。

以下示例使用单行注释来进行代码解释:

示例(代码行之前的注释):

// 输出欢迎信息
echo 'Welcome Home!';

示例(代码行末尾的注释):

echo 'Welcome Home!'; // 输出欢迎信息

3. 使用注释忽略代码

我们还可以使用注释来阻止某些代码行被执行,这在调试时非常有用:

示例(不显示欢迎信息):

// echo 'Welcome Home!';