PHP基础教程（83）PHP数组之输出数组：别再print_r了！PHP数组输出秘籍：从青铜到王者就看这一篇

PHP数组输出全攻略
原创 于 2025-12-08 14:16:44 发布 · 284 阅读 · 7 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#php #r语言 #android

“老板让我把数组输出得优雅点，我反手就是一个var_dump，结果被同事笑了三年——原来数组输出的水这么深！”

在PHP的世界里，数组就是那个装满了各种宝贝的魔法口袋，但很多人只会用print_r和var_dump这两种“基础法术”把口袋里的东西一股脑倒在地上。直到有一天，你需要在网页上展示清晰的数据表格，或者调试一个复杂的多维数组，才发现自己站在一堆杂乱的数据前束手无策。

今天咱们就彻底搞懂PHP数组输出的十八般武艺，让你从“只会倒口袋”升级为“阵列展示大师”，保证你看完后连看自己以前的代码都想笑！

一、为什么你输出的数组总是一团糟？

咱们先来看个经典翻车现场：

<?php
$user = [
    'id' => 1024,
    'name' => '张三',
    'age' => 28,
    'skills' => ['PHP', 'MySQL', 'Redis', 'Vue'],
    'projects' => [
        ['title' => '电商系统', 'status' => '已完成'],
        ['title' => 'OA系统', 'status' => '开发中']
    ]
];

echo $user; // 直接翻车！输出：Array
print_r($user); // 能看但丑炸
?>

相信这种 Array 的无力感你一定经历过。PHP的数组不是字符串，不能直接用echo输出，这是每个新手必踩的第一个坑。

为什么数组不能直接echo？

因为PHP的设计哲学是“明确优于隐式”——数组到字符串的转换太容易出错了。想象一下，如果你有一个包含成百上千个元素的数组，echo会自动帮你拼接吗？怎么分隔？这些都是问题。所以PHP干脆让你自己决定输出格式。

二、青铜选手必备：print_r和var_dump的“爱恨情仇”

1. print_r —— 快速查看的瑞士军刀
<?php
$fruits = ['apple', 'banana', 'cherry' => ['red', 'dark_red'], 99];

echo "<pre>"; // 加个pre标签，瞬间变整齐
print_r($fruits);
echo "</pre>";

// 输出：
/*
Array
(
    [0] => apple
    [1] => banana
    [cherry] => Array
        (
            [0] => red
            [1] => dark_red
        )

    [2] => 99
)
*/
?>

print_r的妙用：

  • 第二个参数设为true，可以捕获输出而不是直接打印
$output = print_r($fruits, true);
file_put_contents('log.txt', $output); // 写入日志文件
2. var_dump —— 调试界的“X光机”

如果说print_r是看表面，那var_dump就是连骨头带血管都给你看清楚：

<?php
$mixedBag = [
    42,
    3.14,
    "Hello",
    true,
    null,
    [1, 2, 3]
];

var_dump($mixedBag);

// 输出：
/*
array(6) {
  [0]=>
  int(42)
  [1]=>
  float(3.14)
  [2]=>
  string(5) "Hello"
  [3]=>
  bool(true)
  [4]=>
  NULL
  [5]=>
  array(3) {
    [0]=>
    int(1)
    [1]=>
    int(2)
    [2]=>
    int(3)
  }
}
*/
?>

var_dump的独门秘籍：

  • 可以同时输出多个变量
var_dump($fruits, $mixedBag); // 一次看俩，对比分析
print_r vs var_dump：何时用哪个？
  • 只想看结构和值 → print_r
  • 需要知道类型和长度 → var_dump
  • 调试复杂数据 → var_dump
  • 生成友好输出 → print_r + <pre>

三、白银段位：遍历输出的艺术

1. foreach —— 数组遍历的“万能钥匙”
<?php
$students = [
    ['id' => 1, 'name' => '小明', 'score' => 85],
    ['id' => 2, 'name' => '小红', 'score' => 92],
    ['id' => 3, 'name' => '小刚', 'score' => 78]
];

// 基础版：只取值
foreach ($students as $student) {
    echo "姓名：{$student['name']}，分数：{$student['score']}<br>";
}

// 进阶版：键值一起要
foreach ($students as $index => $student) {
    echo "第" . ($index + 1) . "位学生：";
    echo "ID: {$student['id']}, ";
    echo "姓名: {$student['name']}, ";
    echo "分数: {$student['score']}<br>";
}

// 实战：生成HTML表格
echo "<table border='1' cellpadding='10'>";
echo "<tr><th>ID</th><th>姓名</th><th>分数</th><th>等级</th></tr>";
foreach ($students as $student) {
    $grade = $student['score'] >= 90 ? 'A' : ($student['score'] >= 80 ? 'B' : 'C');
    echo "<tr>
            <td>{$student['id']}</td>
            <td>{$student['name']}</td>
            <td>{$student['score']}</td>
            <td>{$grade}</td>
          </tr>";
}
echo "</table>";
?>
2. for循环 —— 索引数组的“精确制导”
<?php
$colors = ['红色', '绿色', '蓝色', '黄色', '紫色'];

// 正序遍历
for ($i = 0; $i < count($colors); $i++) {
    echo "第{$i}个颜色是：{$colors[$i]}<br>";
}

// 倒序遍历（没错，可以倒着来！）
for ($i = count($colors) - 1; $i >= 0; $i--) {
    echo "倒数第" . (count($colors) - $i) . "个颜色是：{$colors[$i]}<br>";
}
?>

四、黄金段位：数组函数的高阶玩法

1. json_encode —— 前后端通吃的“翻译官”
<?php
$product = [
    'id' => 'P1001',
    'name' => '智能手机',
    'price' => 2999.99,
    'specs' => [
        '屏幕' => '6.5英寸',
        '内存' => '8GB+256GB',
        '摄像头' => '6400万像素'
    ],
    'in_stock' => true
];

// 基本JSON输出
$json = json_encode($product);
echo $json;
// 输出：{"id":"P1001","name":"智能手机","price":2999.99,"specs":{"屏幕":"6.5英寸","内存":"8GB+256GB","摄像头":"6400万像素"},"in_stock":true}

// 美化输出（人类可读格式）
$prettyJson = json_encode($product, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
echo "<pre>$prettyJson</pre>";

// JSON + HTML展示
echo "<div id='product-data' data-product='" . htmlspecialchars($json) . "'></div>";
?>

json_encode的常用选项：

  • JSON_PRETTY_PRINT：美化输出
  • JSON_UNESCAPED_UNICODE：不转义中文
  • JSON_NUMERIC_CHECK：数字保持为数字（不转字符串）
2. implode —— 数组变字符串的“胶水”
<?php
$tags = ['PHP', 'MySQL', 'JavaScript', 'Vue', 'Redis'];

// 简单拼接
$tagString = implode(', ', $tags);
echo "技术栈：{$tagString}<br>"; 
// 输出：技术栈：PHP, MySQL, JavaScript, Vue, Redis

// 高级玩法：生成SQL语句
$ids = [101, 102, 103, 105];
$sql = "SELECT * FROM users WHERE id IN (" . implode(',', $ids) . ")";
echo "SQL: {$sql}<br>";
// 输出：SELECT * FROM users WHERE id IN (101,102,103,105)

// 生成HTML列表
$htmlList = "<ul><li>" . implode("</li><li>", $tags) . "</li></ul>";
echo $htmlList;
?>

五、钻石段位：自定义输出函数

当你觉得内置函数不够用时，就该自己造轮子了：

<?php
/**
 * 递归美化输出多维数组
 * @param array $array 要输出的数组
 * @param string $title 标题
 * @param int $depth 当前深度（内部使用）
 */
function prettyArray($array, $title = '数组详情', $depth = 0) {
    $indent = str_repeat('  ', $depth * 2);
    
    if ($depth === 0) {
        echo "<div style='font-family: Consolas, monospace; background: #f5f5f5; padding: 20px; border-radius: 5px;'>";
        echo "<h3 style='margin-top: 0;'>🔍 {$title}</h3>";
    }
    
    echo "{$indent}<div style='margin-left: 20px;'>";
    
    foreach ($array as $key => $value) {
        $keyColor = '#d32f2f';
        $typeColor = '#1976d2';
        $valueColor = '#388e3c';
        
        echo "{$indent}  <div style='margin: 5px 0;'>";
        echo "<span style='color: {$keyColor}; font-weight: bold;'>" . htmlspecialchars($key) . "</span>";
        echo " <span style='color: #757575;'>=></span> ";
        
        if (is_array($value)) {
            echo "<span style='color: {$typeColor};'>Array(" . count($value) . ")</span><br>";
            prettyArray($value, '', $depth + 1);
        } else {
            $type = gettype($value);
            $displayValue = is_string($value) ? "'{$value}'" : $value;
            $displayValue = $value === null ? 'null' : $displayValue;
            $displayValue = is_bool($value) ? ($value ? 'true' : 'false') : $displayValue;
            
            echo "<span style='color: {$valueColor};'>{$displayValue}</span>";
            echo " <span style='color: #9e9e9e; font-size: 0.9em;'>[{$type}]</span>";
        }
        
        echo "</div>";
    }
    
    echo "{$indent}</div>";
    
    if ($depth === 0) {
        echo "</div>";
    }
}

// 使用示例
$complexData = [
    'site_info' => [
        'name' => '技术博客',
        'url' => 'https://example.com',
        'visitors' => 15000,
        'online' => true
    ],
    'hot_articles' => [
        ['id' => 1, 'title' => 'PHP8新特性', 'views' => 5000],
        ['id' => 2, 'title' => 'Vue3实战', 'views' => 3200]
    ],
    'config' => [
        'cache_enabled' => true,
        'max_upload_size' => 5242880
    ]
];

prettyArray($complexData, '网站数据统计');
?>

六、王者段位：实战综合应用

让我们用一个完整的电商购物车示例来结束战斗：

<?php
class CartDisplay {
    private $cart;
    
    public function __construct($cartData) {
        $this->cart = $cartData;
    }
    
    // 显示购物车摘要
    public function displaySummary() {
        $total = 0;
        $count = 0;
        
        foreach ($this->cart['items'] as $item) {
            $total += $item['price'] * $item['quantity'];
            $count += $item['quantity'];
        }
        
        return [
            'total_items' => $count,
            'total_price' => $total,
            'formatted_price' => '¥' . number_format($total, 2)
        ];
    }
    
    // 生成HTML表格
    public function renderTable() {
        $html = '<table class="cart-table">';
        $html .= '<thead><tr>
                    <th>商品</th>
                    <th>单价</th>
                    <th>数量</th>
                    <th>小计</th>
                    <th>操作</th>
                 </tr></thead><tbody>';
        
        foreach ($this->cart['items'] as $id => $item) {
            $subtotal = $item['price'] * $item['quantity'];
            $html .= "<tr data-id='{$id}'>
                        <td>{$item['name']}</td>
                        <td>¥{$item['price']}</td>
                        <td>
                            <button class='qty-btn' data-action='decrease'>-</button>
                            <span class='quantity'>{$item['quantity']}</span>
                            <button class='qty-btn' data-action='increase'>+</button>
                        </td>
                        <td class='subtotal'>¥{$subtotal}</td>
                        <td><button class='remove-btn'>删除</button></td>
                      </tr>";
        }
        
        $summary = $this->displaySummary();
        $html .= "</tbody><tfoot>
                    <tr>
                        <td colspan='3' align='right'>总计：</td>
                        <td colspan='2' class='total-price'>{$summary['formatted_price']}</td>
                    </tr>
                  </tfoot>";
        $html .= '</table>';
        
        return $html;
    }
    
    // 导出为JSON（供前端使用）
    public function toJson() {
        return json_encode([
            'cart' => $this->cart,
            'summary' => $this->displaySummary(),
            'timestamp' => date('Y-m-d H:i:s')
        ], JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
    }
    
    // 调试信息
    public function debugInfo() {
        echo "<details style='background: #fff3cd; padding: 15px; border-radius: 5px; margin-top: 20px;'>";
        echo "<summary style='cursor: pointer; font-weight: bold;'>🧪 调试信息</summary>";
        echo "<div style='margin-top: 10px;'>";
        
        echo "<strong>原始数组：</strong><br>";
        echo "<pre style='background: white; padding: 10px;'>";
        print_r($this->cart);
        echo "</pre>";
        
        echo "<strong>JSON格式：</strong><br>";
        echo "<pre style='background: white; padding: 10px;'>";
        echo $this->toJson();
        echo "</pre>";
        
        echo "</div></details>";
    }
}

// 使用示例
$cartData = [
    'user_id' => 1001,
    'items' => [
        101 => ['name' => '无线耳机', 'price' => 399.00, 'quantity' => 1],
        205 => ['name' => 'Type-C数据线', 'price' => 29.90, 'quantity' => 2],
        308 => ['name' => '手机支架', 'price' => 15.50, 'quantity' => 3]
    ],
    'updated_at' => '2024-01-15 14:30:00'
];

$cartDisplay = new CartDisplay($cartData);

echo "<h2>🛒 我的购物车</h2>";
echo $cartDisplay->renderTable();
echo $cartDisplay->debugInfo();

// 保存JSON到文件（实际项目用）
$jsonData = $cartDisplay->toJson();
file_put_contents('cart_backup.json', $jsonData);
?>

七、避坑指南：数组输出的常见雷区

  1. 循环中修改数组：不要在foreach循环中直接增删数组元素，用&引用或改用for循环
  2. 多层嵌套的json_encode失败：检查数组中是否有非UTF-8字符串，或循环引用
  3. 大量数据的内存问题：用yield生成器处理大数组
  4. XSS攻击漏洞：输出到HTML前一定要用htmlspecialchars转义

八、总结：选择你的“武器库”

场景

推荐方法

理由

快速调试

var_dump()

信息最全

日志记录

print_r($arr, true)

可保存到文件

网页展示

foreach + HTML

完全可控的样式

API接口

json_encode()

标准数据交换格式

命令行查看

print_r()

简洁明了

复杂结构

自定义函数

可读性最佳

记住一个黄金法则： 不要为了输出而输出，要为目标而输出。是要给人看，还是要给机器读？是要调试，还是要展示？想清楚这个，你就知道该选哪个工具了。

数组输出看似简单，却体现了你对PHP理解的深度。从今天起，告别混乱的print_r，开始优雅地展示你的数据吧！

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

值引力

持续创作，多谢支持！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值