PHP 语法

---

PHP 脚本在服务器上执行，然后将纯 HTML 结果发送回浏览器。

PHP 使用 <?php ?> 包裹代码。

---

基本的 PHP 语法

PHP 脚本可以放在文档中的任何位置。

PHP 脚本以 <?php 开始，以 ?> 结束：

<?php
// PHP 代码
?>

PHP 文件的默认文件扩展名是 .php。

PHP 文件通常包含 HTML 标签和一些 PHP 脚本代码。

• <?php ...?> 是标准 PHP 标签。
• echo 用于输出内容。
• 每条语句末尾要加 ;。

下面，我们提供了一个简单的 PHP 文件实例，它可以向浏览器输出文本 "Hello World!"：

PHP 中的每个代码行都必须以分号结束。分号是一种分隔符，用于把指令集区分开来。

通过 PHP，有两种在浏览器输出文本的基础指令：echo 和 print。

---

PHP 中的注释

在 PHP 中，注释用来解释代码的作用，不会被执行，也不会输出到页面上。

注释主要有三种形式：

1、单行注释（2 种写法）

使用 //

<?php
// 这是单行注释
echo "Hello"; // 也可以放在语句后面
?>

使用 #

<?php
# 这是另一种单行注释
echo "World";
?>

特点：

• 从 // 或 # 开始，到本行结束为止。
• 常用于简短说明。

2、多行注释（块注释）

使用 /* ... */</p>

<?php
/*
这是多行注释
可以写多行文字
不会被执行
*/
echo "PHP";
?>

特点：

• 以 /* 开始，*/ 结束。
• 可以跨多行书写。
• 常用于较长的代码说明、函数注释等。

3、文档注释（DocBlock 注释）

这是多行注释的特殊形式，用于生成 API 文档，适合描述类、函数等。

<?php
/**
 * 打印问候语
 *
 * @param string $name 用户名
 * @return string 返回问候语
 */
function sayHello($name) {
    return "Hello, $name!";
}
?>

特点：

• 用 /** ... */ 包裹（注意两个星号）
• 支持 @param、@return、@var、@author
• 常用于配合 IDE 或文档生成工具（如 phpDocumentor）

用途	推荐注释形式	示例
简单说明一行代码	// 或 #	// 输出信息
说明一段代码块	/* ... */	用于逻辑分块的注释
函数/类文档说明	/** ... */ DocBlock	用于描述参数、返回值、用途等