PHP print_r() 函数（详细教程）

PHP print_r() 函数：调试利器，开发者必备技能

在 PHP 开发过程中，我们常常需要查看变量的值，尤其是当数据结构复杂时，比如数组、对象等。这时候，print_r() 函数就成为我们最常用的“侦察兵”。它能清晰地输出变量的结构和内容，帮助我们快速定位问题。对于初学者来说，掌握这个函数是迈向调试能力的第一步；而对于中级开发者，熟练运用它能显著提升排错效率。

print_r() 不仅能打印简单变量，还能递归地展示嵌套数组、多维数组、对象属性等复杂结构，是 PHP 中最基础却最实用的调试工具之一。今天我们就来深入聊聊这个函数的使用方法、注意事项和实战技巧。

什么是 PHP print_r() 函数？

print_r() 是 PHP 自带的一个内置函数，用于以人类可读的方式打印变量的结构。它的主要作用是“可视化”变量内容，尤其适合用于调试阶段。

和 echo 或 print 不同，echo 只能输出字符串，而 print_r() 能处理数组、对象、资源等复杂类型，并清晰地展示它们的内部结构。你可以把它想象成一个“透视镜”——透过它，你能看到变量内部到底藏着什么。

<?php
$data = ['name' => '张三', 'age' => 25, 'hobbies' => ['读书', '编程', '跑步']];
print_r($data);
?>

输出结果：

Array
(
    [name] => 张三
    [age] => 25
    [hobbies] => Array
        (
            [0] => 读书
            [1] => 编程
            [2] => 跑步
        )

)

💡 注释：上面这段代码创建了一个包含字符串、数字和嵌套数组的关联数组。print_r() 将其完整地展示出来，包括键名、值以及嵌套结构的层级关系。

基础用法：打印简单变量

print_r() 最简单的用途是打印字符串、整数、浮点数等标量类型。虽然这些类型用 echo 也能输出，但统一使用 print_r() 有助于保持调试风格的一致性。

<?php
$number = 100;
$string = "Hello, PHP!";
$float = 3.14159;

print_r($number);   // 输出：100
print_r($string);   // 输出：Hello, PHP!
print_r($float);    // 输出：3.14159
?>

💡 注释：虽然这些类型输出效果和 echo 差不多，但 print_r() 会自动添加换行符，且在调试环境中更易识别。尤其当你在循环中打印多个变量时，print_r() 的格式会更清晰。

打印数组：从一维到多维

数组是 PHP 中最常见的数据结构。print_r() 在处理数组时表现尤为出色，能清晰展示键值对、索引顺序以及嵌套层级。

创建数组与初始化

<?php
// 一维数组（索引数组）
$fruits = ['苹果', '香蕉', '橙子'];
print_r($fruits);
// 输出：
// Array
// (
//     [0] => 苹果
//     [1] => 香蕉
//     [2] => 橙子
// )

// 关联数组
$person = [
    'name' => '李四',
    'city' => '北京',
    'job' => '程序员'
];
print_r($person);
// 输出：
// Array
// (
//     [name] => 李四
//     [city] => 北京
//     [job] => 程序员
// )
?>

💡 注释：索引数组使用数字键（0,1,2...），而关联数组使用字符串键。print_r() 会分别标明这些键的类型，便于我们判断数据结构。

多维数组的展示

当数组中嵌套了另一个数组时，print_r() 会自动缩进，清晰展示层级关系。

<?php
$students = [
    ['name' => '小王', 'age' => 20, 'scores' => [85, 90, 78]],
    ['name' => '小红', 'age' => 19, 'scores' => [92, 88, 95]],
    ['name' => '小明', 'age' => 21, 'scores' => [76, 84, 89]]
];

print_r($students);
?>

输出结果：

Array
(
    [0] => Array
        (
            [name] => 小王
            [age] => 20
            [scores] => Array
                (
                    [0] => 85
                    [1] => 90
                    [2] => 78
                )

        )

    [1] => Array
        (
            [name] => 小红
            [age] => 19
            [scores] => Array
                (
                    [0] => 92
                    [1] => 88
                    [2] => 95
                )

        )

    [2] => Array
        (
            [name] => 小明
            [age] => 21
            [scores] => Array
                (
                    [0] => 76
                    [1] => 84
                    [2] => 89
                )

        )

)

💡 注释：多维数组结构复杂，print_r() 的缩进和括号层级清晰地表达了数据之间的关系。你可以轻松看出每个学生有姓名、年龄和成绩数组。

打印对象：查看属性与方法

print_r() 不仅能处理数组，还能打印对象（Object）的结构。它会显示对象的所有公共属性，但不会显示私有或受保护的属性。

<?php
class User {
    public $name;
    public $email;
    private $password;

    public function __construct($name, $email) {
        $this->name = $name;
        $this->email = $email;
    }

    public function greet() {
        return "你好，我是 " . $this->name;
    }
}

$user = new User("王五", "wangwu@example.com");
print_r($user);
?>

输出结果：

User Object
(
    [name] => 王五
    [email] => wangwu@example.com
)

💡 注释：可以看到，print_r() 只显示了 public 属性（name 和 email），而 private 属性 password 没有被打印出来。这说明 print_r() 在对象调试时会遵守访问控制规则。

实用技巧与注意事项

虽然 print_r() 很好用，但在实际开发中仍需注意一些细节，避免踩坑。

1. 不要用于生产环境输出

print_r() 的输出是原始的、未经格式化的文本，直接输出到网页上会破坏页面结构。因此，在正式上线的项目中，绝对不要使用 print_r() 输出数据。

✅ 正确做法：使用日志系统（如 error_log()）或调试工具（如 Xdebug）。

// 错误示例（避免在生产环境使用）
print_r($data);

// 正确示例
error_log(print_r($data, true)); // true 表示不直接输出，而是返回字符串

💡 注释：print_r($data, true) 会将输出结果作为字符串返回，而不是直接打印到页面，适合用于日志记录。

2. 与 var_dump() 的区别

print_r() 和 var_dump() 都用于调试，但它们有明显区别：

<?php
$data = "Hello";
print_r($data);     // 输出：Hello
var_dump($data);    // 输出：string(5) "Hello"
?>

💡 注释：当你不确定变量类型是否正确时，var_dump() 更适合；而当你只想快速看结构时，print_r() 更简洁。

常见问题与解决方案

1. 输出内容被浏览器截断？

在某些环境下，print_r() 输出的内容可能被浏览器或服务器限制。建议使用 error_log() 将输出记录到日志文件，而不是直接输出到页面。

// 将输出保存到日志文件
error_log(print_r($large_array, true));

2. 如何避免重复输出？

在调试循环中，避免多次调用 print_r() 导致输出混乱。可以加一个开关控制：

$debug = true;

if ($debug) {
    print_r($data);
}

总结

PHP print_r() 函数 是每位 PHP 开发者必备的调试工具。它能清晰展示数组、对象等复杂数据结构，帮助我们快速理解变量内容。从初学者到资深开发者，掌握它的使用方法都能显著提升开发效率。

记住：

• 它适合在开发调试阶段使用；
• 不要在生产环境中直接输出；
• 配合 error_log() 使用更安全；
• 理解它与 var_dump() 的差异，选择合适的工具。

当你遇到“数据不对劲”时，别急着猜，先用 print_r() 看一眼。也许，问题就在那一行输出里。