在编写php代码的过程中，注释的作用是非常重要的，注释可以帮助我们更好的理解代码的功能以及实现的过程。在php中添加注释的方法也是非常简单的，并且对于不同的编码习惯，可以使用多种注释的方式。本文将介绍在php中添加注释的方法以及常见的注释方式。
- 单行注释
在PHP中，用//来表示单行注释。与C，Java等其他编程语言类似，使用//在代码行的末尾添加注释，如下所示：
<?php // 这是一行注释 echo "Hello World!"; ?>
- 多行注释
当我们需要在一段代码中添加多行注释时，使用/ /方式。
<?php /* 这是多行注释 这是多行注释的第二行 */ echo "Hello World!"; ?>
- 文档注释
文档注释是在函数、类、接口、属性等代码块前添加详细的注释，以方便别人更好的理解这些代码块的功能。
在PHP中，使用/* /表示文档注释，例如：
立即学习“PHP免费学习笔记（深入）”；
<?php
/**
* 这是一个函数
* @param string $name
* @return string
*/
function sayHello($name) {
return "Hello ".$name;
}
?>- 注释样式
对于注释样式，主要有两种: C风格和JavaDoc风格。
C风格注释使用/ /和/ */，与C编程语言类似。JavaDoc风格注释从/开始，使用@符号来描述注释的重点，例如：
<?php
/**
* This is a function.
* @param string $name Your name.
* @return string A greeting message.
*/
function sayHello($name) {
return "Hello ".$name;
}
?>这种方式的注释可以通过一些工具转换成HTML，作为函数或代码的详细文档。同时，许多集成开发环境（IDE）支持以下标识符来解析JavaDoc注释，使它们在代码提示和自动完成中更加有用。
在PHP 7.0及以上版本中，除了JavaDoc风格注释外，还可以使用返回值类型等特殊标记，例如：
<?php
/**
* This is a function.
* @param string $name Your name.
* @return string A greeting message.
*/
function sayHello(string $name): string {
return "Hello ".$name;
}
?>可以看到，返回值类型标记是在参数列表后加上冒号来表示的。
总结：
在PHP中，添加注释是非常重要的，可以让我们更好地理解代码的功能，也能够方便我们日后的维护和修改。通过本文我们可以学习到在PHP中不同方法的注释方式以及对应的语法规则，这对于自学PHP的朋友们来说是非常有用的。
