PHP - 注释



任何计算机程序(例如 PHP 程序)中的注释都是被语言编译器/解释器忽略的某个解释性文本。其目的是帮助用户理解程序算法中使用的逻辑。

尽管在代码中放置注释不是必需的,但强烈建议这样做。这些注释还用作程序文档。当需要调试和修改代码时,注释也很有用。

PHP 中有两种注释格式 -

  • 单行注释
  • 多行注释

单行注释

它们通常用于简短说明或注释。PHP 使用两种表示法在程序中插入单行注释。

使用 “#” 的单行注释

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


<?php
	 	# 以#符号开头的单行注释
	 	echo 'Hello World';
?>

使用 “//” 的单行注释

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


<?php
	 	// 以//符号开头的单行注释
	 	echo 'Hello World';
?>

以符号 “#” 或 “//” 开头的注释不需要关闭。这些符号的效果一直持续到物理线的末尾。

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

多行注释

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

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

PHP 中的多行注释示例

下面是多行注释的示例。


<?php

	 	/* 这是一个多行注释示例
	 	   将两个数字相加的程序
	 	   使用的变量-第一个数字为$x
	 	   第二个数字为$y */
	 	
	 	$x=10;
	 	$y=20;
	 	print "Total = ". $x+$y;
?>

请注意,您甚至可以在 “/* ..*/“ 符号。但是,如果程序中有 “/*” 符号,则它必须具有结束注释标记 “*/”。否则,将显示如下错误 -

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