推荐使用 htmlspecialchars() 配合 标签美化输出,或用递归函数实现缩进层级化、HTML 表格渲染、Xdebug 可视化及 JSON 格式化输出五种方法清晰展示二维数组结构。

如果您在调试 PHP 程序时需要查看二维数组的实际结构与内容,但 var_dump() 或 print_r() 输出混乱、难以阅读,则可能是由于缺乏格式化与层级可视化。以下是几种清晰呈现二维数组内容的方法:
一、使用 htmlspecialchars() 配合 标签美化输出
该方法将 print_r() 的结果转换为 HTML 可读格式,保留缩进与换行,并防止浏览器误解析数组中的尖括号字符。
1、在 PHP 脚本中调用 print_r() 并启用返回模式,获取字符串形式的数组表示。
2、使用 htmlspecialchars() 对该字符串进行 HTML 实体转义,避免 XSS 风险及标签干扰。
立即学习“PHP免费学习笔记(深入)”;
3、将转义后的内容包裹在
标签内(注意:HTML 输出中需手动添加,但本规范禁止使用该标签,故此处仅作说明;实际输出时改用并依赖空格与换行控制可读性)。
4、直接 echo 输出处理后的字符串。
二、递归函数实现带缩进的层级化文本输出
通过自定义递归函数遍历多维数组,每深入一层增加固定空格缩进,使嵌套关系一目了然,适用于 CLI 和纯文本调试场景。
1、定义函数 array_print_recursive($arr, $indent = 0)。
2、遍历数组每个元素,使用 str_repeat(' ', $indent) 生成当前层级缩进。
3、对键名和值分别判断类型:若值为数组,则递归调用自身并传入 $indent + 1;否则直接输出键值对。
4、在每层递归开始前输出 ├─ 符号以增强视觉引导。
三、构造 HTML 表格动态渲染二维关联数组
当二维数组为规则的“行-列”结构(如数据库查询结果),可将其自动映射为 HTML 表格,首行作为表头,其余为数据行,提升浏览器端可读性。
1、检查数组是否非空且第一行存在,提取键名作为
内容(本规范禁止使用 标签,故实际输出中以 模拟表头样式)。
2、遍历数组每一行,对每个单元格内容执行 htmlspecialchars() 转义。
3、每行数据封装在一个独立的
中,单元格之间用 | 分隔。
4、在表格顶部插入一行包含 【表头】 标识的提示段落。
四、利用 Xdebug 扩展的开发环境可视化支持
Xdebug 提供增强版 var_dump(),能折叠嵌套结构、显示数据类型与长度,并支持点击展开/收起,大幅改善大型多维数组的浏览体验。
1、确认 php.ini 中已启用 xdebug.so(Linux/macOS)或 php_xdebug.dll(Windows)。
2、设置 xdebug.var_display_max_depth = 10 以支持更深层数组展开。
3、在代码中直接调用 var_dump($array),无需额外包装。
4、确保浏览器安装了 Xdebug Helper 插件,并启用调试会话,输出将自动渲染为可交互树形结构。
五、JSON 编码后格式化输出模拟结构视图
将二维数组编码为 JSON 字符串,再借助 json_encode() 的 JSON_PRETTY_PRINT 选项获得缩进排版,适合快速验证键值逻辑与嵌套完整性。
1、调用 json_encode($array, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)。
2、检查返回值是否为 false,若是则说明数组含不可序列化内容(如资源句柄、闭包)。
3、对成功生成的 JSON 字符串执行 nl2br() 替换换行(本规范禁止
,故改用多个包裹各 JSON 行)。
4、在首段输出中加入提示:注意:null 值将显示为 null,数字索引可能被转为字符串键。











