ThinkPHP 支持三种类型的注释:
//
开头的注释,可以对一行代码进行注释。例如:
// 这是一行单行注释
$name = 'ThinkPHP';
/*
开头和以 */
结尾,可以对多行代码进行注释。例如:
/*
这是一个多行注释
可以对多行代码进行注释
*/
$name = 'ThinkPHP';
/**
开头和以 */
结尾,支持使用一些特殊的标记来生成文档。例如:
/**
* 这是一个文档注释
* @param string $name 名称
* @param int $age 年龄
* @return string 返回欢迎信息
*/
function sayHello($name, $age) {
return "欢迎{$name},你的年龄是{$age}岁";
}
其中,文档注释中的 @param
用于标记参数,@return
用于标记返回值。在生成文档时,可以根据这些标记生成对应的文档。