Php 简明教程

PHP - Comments

任何计算机程序（如 PHP 程序）中的注释都是一种特定的解释性文本，语言编译器/解释器会忽略它。其目的是帮助用户理解程序算法中使用的逻辑。

尽管在代码中放置注释并不是必须的，但这是强烈推荐的做法。注释也可以作为程序文档。在需要调试和修改代码时，注释也非常有用。

PHP 有两种注释格式 -

  1. Single-line Comments

  2. Multi-line Comments

Single-line Comments

它们通常用于短说明或与本地代码相关的注释。PHP 使用两种符号在程序中插入单行注释。

Single-line Comments Using "

以“#”符号开头的 PHP 代码中的行被视为单行注释。

<?php
   # Single line comment starting with # symbol
   echo 'Hello World';
?>

Single-line Comments Using "//"

PHP 还支持以“//”符号为单行注释的 C 样式。以双斜线符号开头的行被视为注释。

<?php
   // Single line comment starting with // symbol
   echo 'Hello World';
?>

以符号 “#”或 “//”开头的注释不需要关闭。这些符号的作用持续到物理行的末尾。

换句话说，PHP 解析器会将下一行作为 PHP 语句对待，而不是注释，即使没有注释结束标记。

Multi-line Comments

多行注释通常用于在必要时提供伪代码算法和更详细的说明。

多行注释的样式与 C 中相同。嵌入在符号 “/ " and " /”内的行或多行被视为注释。

Example of Multi-line Comment in PHP

这是一个多行注释的示例。

<?php

   /* This is a multiline comment example
   program to add two numbers
   Variables used - $x for first number,
   $y for second number */

   $x=10;
   $y=20;
   print "Total = ". $x+$y;
?>

请注意，您甚至可以将单行放在程序中的 “/* .. /" symbols. However, if there is a "/ " 符号内，它必须有一个注释结束标记 “*/”。如果没有，将显示以下错误 -

PHP Parse error:  Unterminated comment starting line 3 in /home/cg/root/65ded9eeb52fc/main.php on line 3