在PHP中打印数据(调试、输出内容)的多种方法

更新时间：2025年11月07日 09:10:57 作者：游九尘

这篇文章主要介绍了PHP中常用的打印数据方法,包括核心打印函数（如echo、print_r、var_dump、var_export）以及特殊场景下的打印方式（如日志打印、控制台打印、多维数组格式化）,同时,还分享了调试时的常用技巧,需要的朋友可以参考下

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

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

特点：无返回值，可输出多个字符串，速度快，适合页面直接显示内容。
语法：echo 字符串/变量（可省略括号）。
示例：

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

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

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

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

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

特点：格式化输出数组、对象、字符串，可读性强，适合调试复杂数据类型。
语法：print_r(变量, 是否返回字符串)（第二个参数为 true 时，不直接输出，返回字符串）。
示例：

// 打印数组
$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);

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

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

特点：不仅输出值，还显示数据类型和长度，适合精准调试（如判断变量是否为 null、数组维度等）。
语法：var_dump(变量1, 变量2, ...)。
示例：

$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 => '王五', )

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

二、特殊场景打印

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

适合生产环境调试（不影响用户界面），通过 file_put_contents() 将打印内容写入日志文件：

// 定义日志文件路径
$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 模式）

如果通过命令行（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 选项）：

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

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

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

三、常用打印技巧

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

用分隔符包裹打印结果，避免多个变量输出混淆：

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

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 代码
日志打印	生产环境调试	不影响用户，留存调试记录