PHP echo()函数讲解

前言

严格来说，echo不是函数，而是语言结构（language construct）。这个区别不是术语洁癖，它带来了一连串真实后果：echo不能当回调传参、不能用变量函数调用、不能被disable_functions关闭、也没有返回值。很多人在写框架代码时栽在这一点上，比如想用array_map('echo', $arr)或者把$fn = 'echo'当成可调用对象。

第二个常被搞混的对象是print。两者都能输出字符串，但print是「有返回值的表达式」（返回1），而echo返回void（没有返回值）。这决定了print能出现在表达式里，而echo不能。

本文讲清echo的参数规则、它与print/printf/print_r的分工、括号形式的边界，以及输出时最容易踩的转义与缓冲坑。

一、语法与参数规则

echo的语法允许两种写法，二者都是合法的：

<?php // 适用于 PHP 8.0+
$name = 'PHP';

// 写法 A：不带括号，可以一次输出多个表达式，用逗号分隔
echo 'Hello, ', $name, '!', PHP_EOL;

// 写法 B：带括号，但括号里只能有「一个」表达式
echo('Hello, ' . $name . '!' . PHP_EOL);

关键规则是：逗号分隔的多个参数只在「不带括号」的形式下成立。echo($a, $b)不是「输出两个值」，而是一个语法错误。原因是带括号时echo后面接的是一个普通表达式，而普通表达式里逗号不是运算符（这一点和printf()、sprintf()这类真函数完全不同）。

echo的「返回值」永远是没有的，所以下面这种写法不成立：

Parse error: syntax error, unexpected token "echo"

会报错的写法就是$x = echo 'hi';——表达式位置不允许出现echo。如果你需要一个能出现在表达式里的输出手段，用print。

至于<?=短标签，它等价于<?php echo，并且从 PHP 5.4 起不再受short_open_tag配置影响，永远可用。所以在模板里写<?= htmlspecialchars($name) ?>是完全可靠的写法，而<?那种短开标签则不可靠，很多环境默认关闭。

二、和 print / printf / print_r 的分工

常见的错误分工是把print_r()当作页面输出手段：print_r($data)直接输出的是给人看的调试格式，不是可复用的字符串；要让print_r()返回字符串，必须传第二个参数：

<?php // 适用于 PHP 8.0+
$data = ['a' => 1, 'b' => [2, 3]];

// 直接输出：会被当作页面内容，且不转义
print_r($data);

// 取回字符串（第二参数为 true）
$text = print_r($data, true);
var_dump(is_string($text)); // bool(true)

而printf()和echo的一个重要差别是：printf()会把内容按格式说明符处理，%是格式字符。下面这段代码会直接报参数不足：

<?php // 适用于 PHP 8.0+
// ❌ 想输出 100%，printf 会把 % 当格式符
printf('完成度 100%');
// PHP 8 抛出 ArgumentCountError：格式符 % 之后没有对应参数

要输出字面的百分号，得写成%%。

三、拼接还是逗号：原理上的区别

echo $a, $b与echo $a . $b结果相同，但执行的路径不同。

拼接用.时，PHP 必须先构造出一个新的字符串：把$a的内容和目标字符串的内容复制进一块新内存，再把$b追加进去，然后echo输出这个完整结果。字符串越长、拼接次数越多，中间产物就越多（PHP 字符串是写时复制 copy-on-write，但拼接本身一定会产生新串）。

逗号形式下，echo每遇到一个表达式就把它的值写进输出缓冲，不需要先构造完整字符串。

结论是原理层面的：输出的内容本身是同一份字节，差别在于要不要先拼一个中间字符串。在循环里拼一个巨大的 HTML 片段再一次性echo，和直接分段echo相比，前者多了一份完整副本的内存开销。至于具体快多少，取决于数据和运行环境，本文不给没有实测来源的数字——你可以自己写两段循环用microtime(true)对比。

真正需要注意的是编码问题，而不是性能：拼接时如果混入null，结果是字符串""；混入布尔false会变成空串，true会变成"1"。逗号形式下同样如此，因为每个参数都会先被转换成字符串。

<?php // 适用于 PHP 8.0+
$flag = false;
echo 'flag=' , $flag, PHP_EOL; // 输出 flag=
var_dump($flag ? '1' : '0'); // 想要 "0" 时必须显式处理

四、输出转义与输出缓冲

echo本身不做任何转义。它是一个纯粹的字节输出通道，内容里有什么就输出什么。所以把用户输入直接echo到 HTML 里就是 XSS（跨站脚本）的来源。防御侧的做法是在输出点统一转义：

<?php // 适用于 PHP 8.0+ 的防御示例
$userInput = $_GET['q'] ?? '';

// 输出到 HTML 文本节点：转义 & < > " '
echo htmlspecialchars($userInput, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');

// 输出到 HTML 属性：同样用 htmlspecialchars，且属性值必须整体加引号
// echo '<input value="' . htmlspecialchars($userInput, ENT_QUOTES, 'UTF-8') . '">';

// 输出到 JavaScript 数据：用 json_encode，而不是手拼字符串
// echo '<script>var q = ' . json_encode($userInput, JSON_HEX_TAG | JSON_HEX_AMP) . ';</script>';

几个要点：htmlspecialchars()必须传'UTF-8'作为第三个参数（PHP 8.1 起默认值就是 UTF-8，但显式写出更稳）；ENT_QUOTES会同时转义单引号，这在属性里很关键；要输出到 URL 参数就用urlencode()，输出到 SQL 就用参数化查询（echo永远不该参与拼 SQL）。

关于缓冲：echo的输出会先进入 PHP 的输出缓冲（output buffering，ob_start()开启），再交给 Web 服务器。这带来两个实用技巧：

<?php // 适用于 PHP 8.0+（CLI 下可直接运行）
ob_start();
echo 'hello', ' ', 'world';
$captured = ob_get_clean(); // 取出缓冲内容并关闭缓冲
var_dump($captured); // string(11) "hello world"

ob_get_clean()是「取回 + 清空」，ob_get_contents()是只取回不清空，ob_end_clean()是清空并关闭。用 CLI 跑php demo.php时，输出缓冲默认也是可用的。

还有一个经典错误是「header()之前已经有输出」。HTTP 响应头必须在响应体之前发出，只要有一字节（包括 UTF-8 BOM、?>之后的一个换行）被echo出去，header()就会警告Cannot modify header information - headers already sent。防御手段就是：纯 PHP 文件的结尾不写?>，或者用输出缓冲把整段渲染包起来。

常见坑点

1. 
   
2. ❌echo($a, $b);想一次输出两个值。
3. 
   

✅ 去掉括号：echo $a, $b;；或者用拼接：echo $a . $b;。

1. 
   
2. ❌array_map('echo', $arr)或$f = 'echo'; $f('x');，把echo当函数用。
3. 
   

✅echo是语言结构，不能当回调。用print_r/implode等真函数：echo implode('', $arr);。

1. 
   
2. ❌$ok = print('hi');之后想用$ok = echo 'hi';替代。echo没有返回值，赋值会直接语法错误。
3. 
   

✅ 需要返回值就用print（返回 1），需要拼接结果就用sprintf()。

1. 
   
2. ❌ 把用户输入直接输出：echo $_GET['name'];。
3. 
   

✅echo htmlspecialchars($_GET['name'], ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');。

1. 
   
2. ❌printf('优惠 30%');想输出百分号，结果 PHP 8 抛ArgumentCountError。
3. 
   

✅printf('优惠 30%%');或改用echo '优惠 30%';。

1. 
   
2. ❌ 在header('Location: ...')之前有任何echo（哪怕是调试用的空格），导致头信息无法发送。
3. 
   

✅ 先header()再输出，或者用ob_start()包裹；纯 PHP 文件结尾不要写?>。

1. 
   
2. ❌ 用echo $arr;打印数组，得到的是Array加上一条Array to string conversion警告，完全不知道内容。
3. 
   

✅ 调试用var_dump($arr)或print_r($arr, true)；要输出成结构化数据用json_encode($arr)。

1. 
   
2. ❌ 认为echo $a . $b;比echo $a, $b;「更慢所以不能用」，或者反过来断言「快多少倍」。
3. 
   

✅ 差别是「要不要先构造一个中间字符串」这一原理层面的区别；具体差异请用microtime(true)在自己的数据上实测。

总结

用echo时记住三句话：它不是函数，所以别放进回调；它不转义，所以输出到 HTML 必须走htmlspecialchars()；它直接写输出缓冲，所以任何header()都得排在它前面。