在 PHP 开发中，打印数据几乎是每天都会遇到的场景。无论是快速查看变量内容，还是排查复杂的数据结构，选择正确的打印方式都能让效率翻倍。磨刀不误砍柴工，我们先从几个核心场景说起。

一、核心打印函数（按使用频率排序）

1. echo - 最基础的输出（推荐页面显示）

echo 是 PHP 中最基础的输出指令，也是页面显示场景下最顺手的选择。它没有返回值，但可以输出多个字符串，执行速度非常快。语法上，括号可以省略，直接写 echo 字符串/变量 即可。

来看看几个常用用法：

// 1. 输出字符串
echo "Hello PHP!";
echo '单引号字符串也支持';

// 2. 输出变量
$name = "张三";
$age = 25;
echo "姓名：" . $name . "，年龄：" . $age; // 字符串拼接（用 . 连接）

// 3. 输出多个值（用逗号分隔）
echo "姓名：", $name, "，年龄：", $age;

// 4. 输出HTML
echo "
这是标题
";

2. print_r() - 打印数组/对象（推荐调试）

当需要查看数组或对象的结构时，print_r() 是调试利器。它会把数据格式化输出，可读性非常好。第二个参数可以控制是否返回字符串而不是直接输出——这一点在生产环境调试中非常有用。

// 打印数组
$list = ['张三', '李四', '王五'];
print_r($list);
// 输出结果：Array ( [0] => 张三 [1] => 李四 [2] => 王五 )

// 打印关联数组
$user = [
  'id' => 1,
  'name' => '张三',
  'dept' => '技术部'
];
print_r($user);
// 输出结果：Array ( [id] => 1 [name] => 张三 [dept] => 技术部 )

// 打印对象（如之前的 $list 集合）
$list = $this->allEmployeeList();
print_r($list);

// 可选：用 
 标签格式化输出（页面查看更清晰）
echo "
";
print_r($list);
echo "
";


3. var_dump() - 调试神器（显示数据类型+值）

var_dump() 是调试场景中的王牌函数。它不仅能输出值，还会显示数据类型和长度。比如判断变量是否为 null、确认数组维度时，var_dump() 给出的信息是最完整的。可以一次传入多个变量，非常方便。

$name = "张三";
$age = 25;
$isMale = true;
$salary = null;

var_dump($name, $age, $isMale, $salary);
// 输出结果：
// string(6) "张三" （字符串，长度6字节）
// int(25) （整数）
// bool(true) （布尔值）
// NULL （空值）

// 调试数组（显示每个元素的类型）
$user = ['id' => 1, 'name' => '张三'];
var_dump($user);


4. var_export() - 可复用的数组/对象打印

这个函数的价值在于：它输出的内容是合法的 PHP 代码。也就是说，你可以直接把 var_export() 打印的结果复制到代码中使用，省去手动构造数组的麻烦。这在需要快速搭建测试数据时特别好用。

$list = ['张三', '李四', '王五'];
var_export($list);
// 输出结果（可直接复制到代码中使用）：
// array ( 0 => '张三', 1 => '李四', 2 => '王五', )

// 结合 
 格式化
echo "
";
var_export($list);
echo "
";


二、特殊场景打印

1. 调试时打印到日志文件（避免页面干扰）

生产环境调试最忌讳直接输出到页面，容易影响用户界面或暴露敏感信息。这时用 file_put_contents() 把内容写入日志文件是个好办法。如果配合 var_export() 的第二个参数（返回字符串），可以很干净地构建日志内容。

// 定义日志文件路径
$logFile = './debug.log';

// 要打印的变量
$list = $this->allEmployeeList();

// 拼接日志内容（包含时间戳）
$logContent = date('Y-m-d H:i:s') . " - ";
$logContent .= var_export($list, true) . "\n\n"; // 第二个参数为 true，返回字符串

// 写入日志文件（FILE_APPEND 表示追加内容，避免覆盖）
file_put_contents($logFile, $logContent, FILE_APPEND);


2. 打印到控制台（CLI 模式）

如果通过命令行运行 PHP 脚本，echo、print_r()、var_dump() 会直接输出到控制台。这种场景非常适合脚本调试——不需要打开浏览器，直接在终端看结果。

// 脚本文件：test.php
$list = ['张三', '李四', '王五'];
var_dump($list);

// 命令行执行：php test.php
// 控制台输出：
// array(3) { [0]=> string(6) "张三" [1]=> string(6) "李四" [2]=> string(6) "王五" }


3. 打印多维数组/复杂对象（清晰格式化）

对于多层嵌套的数组或对象，用 json_encode() 配合 JSON_PRETTY_PRINT 选项格式化输出，效果非常清晰。同时加上 JSON_UNESCAPED_UNICODE 避免中文转义，这样打印出来的结果就是人类可读的 JSON 格式。

$complexData = [
  'company' => 'XX科技',
  'depts' => [
    [
      'name' => '技术部',
      'employees' => ['张三', '李四']
    ],
    [
      'name' => '人事部',
      'employees' => ['王五', '赵六']
    ]
  ]
];

// JSON 格式化输出（页面查看更清晰）
echo "
";
echo json_encode($complexData, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo "
";



JSON_UNESCAPED_UNICODE：避免中文转义（如 \u5f20\u4e09）。
JSON_PRETTY_PRINT：格式化输出（换行、缩进）。


三、常用打印技巧

1. 调试时快速区分打印内容

多个变量输出时容易混淆，用分隔符包裹打印结果能有效避免：

echo "===== 打印员工列表 =====" . "
";
print_r($list);
echo "
" . "===== 打印结束 =====" . "
";


2. 打印后终止脚本执行

调试时，打印变量后用 die() 或 exit() 终止脚本，避免后续代码干扰：

$list = $this->allEmployeeList();
var_dump($list);
die(); // 终止脚本
// 后续代码不会执行


3. 避免 null/false 打印无结果

echo 打印 null、false 时会显示空值，让人摸不着头脑。这时结合 var_dump() 就能一目了然：

$salary = null;
echo $salary; // 无输出
var_dump($salary); // 输出 NULL，更清晰


四、总结




函数
适用场景
核心优势




echo
页面输出字符串、变量
速度快，支持多值输出


print_r()
调试数组、对象
格式清晰，可读性强


var_dump()
精准调试（类型+值+长度）
显示数据类型，适合排错


var_export()
复用数组/对象代码
输出可执行 PHP 代码


日志打印
生产环境调试
不影响用户，留存调试记录




推荐组合


页面输出简单内容：用 echo。
调试数组/对象：用 print_r($var) 或 var_dump($var) + 
 标签。
生产环境调试：用日志打印（file_put_contents() + var_export()）。