PHP数组打印被截断通常因Xdebug等配置限制，可通过修改php.ini、ini_set()动态覆盖、自定义递归函数、禁用xdebug.overload_var_dump或使用CLI模式解决。
如果您在使用 PHP 打印数组时发现输出被截断、显示不全或仅显示部分元素，这通常是因为开发环境（如 Xdebug、Zend 引擎配置或 IDE 内置调试器）对 var_dump()、print_r() 等函数设置了默认的嵌套深度或字符串长度限制。以下是调整这些限制的具体操作方法：
一、修改 Xdebug 配置限制
Xdebug 是最常影响数组打印完整性的扩展，它通过多个参数控制 var_dump() 的输出行为，包括最大嵌套深度、最大字符串长度和最大子项数。需直接编辑 php.ini 或 xdebug.ini 文件进行调整。
1、打开 PHP 配置文件 php.ini（可通过 php --ini 命令定位路径）。
2、查找并修改以下 Xdebug 相关配置项（若不存在则新增）：
立即学习“PHP免费学习笔记（深入）”；
3、设置 xdebug.var_display_max_depth = 10，允许最多展开 10 层嵌套结构。
4、设置 xdebug.var_display_max_children = 256，允许每个数组或对象最多显示 256 个子元素。
5、设置 xdebug.var_display_max_data = 1024，允许每个字符串值最多显示 1024 字符（设为 -1 表示无限制）。
6、保存文件后重启 Web 服务器（如 Apache 或 Nginx）及 PHP-FPM 进程。
二、运行时动态覆盖 Xdebug 限制
当无法修改 php.ini（如共享主机环境），可在脚本开头使用 ini_set() 函数临时覆盖 Xdebug 的运行时配置，适用于单次调试需求。
1、在 PHP 脚本最顶部添加如下代码：
2、调用 ini_set('xdebug.var_display_max_depth', '10');
3、调用 ini_set('xdebug.var_display_max_children', '512');
4、调用 ini_set('xdebug.var_display_max_data', '2048');
5、确保该段代码位于任何 var_dump() 或 print_r() 调用之前执行。
三、使用自定义递归打印函数控制输出长度
为避免依赖外部扩展且实现精确控制，可编写一个轻量级的递归打印函数，支持手动设定最大深度、最大元素数及字符串截断长度，完全绕过 Xdebug 与 Zend 的内置限制。
1、定义函数 function safe_print_array($arr, $max_depth = 5, $max_items = 100, $max_str_len = 128) { ... }。
2、在函数内部使用静态计数器跟踪当前递归深度，并在超过 $max_depth 时返回 '[...deep...]'
3、对数组键值对进行遍历前，判断当前层级元素总数是否已达 $max_items，超出则中断并追加 '[...truncated...]' 提示。
4、对字符串值调用 substr($val, 0, $max_str_len) 截断，并在截断处添加 '...' 标识。
5、调用该函数替代原生 var_dump()，例如：safe_print_array($data, 3, 50, 64);
四、禁用 Xdebug 的 var_dump 覆盖功能
某些版本 Xdebug 会强制接管 var_dump() 行为。若仅需原始 PHP 输出，可临时关闭其覆盖机制，使 var_dump() 回退至 Zend 默认实现，该实现无默认长度限制（但受 memory_limit 影响）。
1、在脚本中执行 ini_set('xdebug.overload_var_dump', 'Off');
2、注意该设置仅在 Xdebug 已启用且支持此指令的版本中有效（Xdebug 2.6+）。
3、随后调用 var_dump($array) 将不再受 Xdebug 格式化规则约束。
4、若需恢复，可设为 'On' 或 '1'；该设置不影响其他 Xdebug 功能（如断点调试）。
五、使用 CLI 模式绕过 Web 环境限制
Web 服务器环境（尤其是集成开发环境如 PhpStorm、VS Code 的调试插件）常额外限制输出长度。切换至命令行 PHP 执行可规避多数前端截断逻辑。
1、将待调试数组写入独立 PHP 文件，例如 debug.php，内容为：
2、在终端中执行 php -dxdebug.var_display_max_depth=10 -dxdebug.var_display_max_children=512 debug.php
3、PHP CLI 模式默认不加载部分 IDE 插件钩子，且支持通过 -d 参数直接传入配置项。
4、输出将完整呈现至终端，不受浏览器响应体大小或 JS 渲染限制影响。
