PsySH 在 Alpine Docker 容器中的输出异常问题解析

在使用 PsySH（PHP 交互式 Shell）时，部分用户在 Alpine Linux 的 Docker 容器中遇到了奇怪的输出问题。本文将深入分析这一现象的原因，并提供解决方案。

问题现象

当用户在基于 Alpine Linux 的 Docker 容器中运行 PsySH 时，可能会遇到以下异常情况：

1. 命令输入行在执行后消失
2. 输出格式异常，类似 less 分页器的显示效果
3. 变量赋值等简单操作也会触发分页行为

根本原因

经过深入分析，发现这个问题由多个因素共同导致：

1. BusyBox 的 less 实现：Alpine Linux 默认使用 BusyBox 提供的 less 命令，其功能与 GNU less 存在差异，特别是缺少 -X/--no-init 参数支持。

2. 自动分页机制：PsySH 默认会尝试使用系统分页器（通过检测 cli.pager 配置或查找 less 命令），当检测到 pcntl 扩展可用时会自动启用。

3. 交互冲突：BusyBox 的 less 在处理终端控制序列时与 PsySH 的交互模式产生冲突，导致显示异常。

解决方案

临时解决方案

1. 禁用 pcntl 扩展：

return [
    'usePcntl' => false
];

2. 明确指定不使用分页器：

return [
    'pager' => null
];

永久解决方案

PsySH 已在最新版本中增加了对 BusyBox less 的检测逻辑，当发现 less 是 BusyBox 的符号链接时，会自动禁用分页功能。用户只需升级到最新版 PsySH 即可解决此问题。

替代方案

如果需要保留分页功能，可以安装完整版 less：

apk add less

技术细节

PsySH 的分页机制工作流程：

1. 检查是否显式设置了分页器配置
2. 如果未设置且 pcntl 扩展可用，尝试获取系统默认分页器（检查 cli.pager 或查找 less）
3. 执行命令后将长输出通过分页器显示

在 Alpine 环境中，BusyBox 的 less 无法正确处理终端初始化/反初始化序列，导致屏幕刷新异常。最新版 PsySH 通过以下方式检测 BusyBox：

if (is_link($lessPath) {
    $linkTarget = readlink($lessPath);
    if (str_contains($linkTarget, 'busybox')) {
        return null; // 禁用分页
    }
}

最佳实践建议

1. 对于 Alpine 容器环境，建议使用最新版 PsySH
2. 如需分页功能，显式安装 GNU less
3. 在容器构建时考虑明确设置 PsySH 配置，避免依赖自动检测

通过以上分析和解决方案，开发者可以更好地在 Alpine 容器环境中使用 PsySH，获得顺畅的交互式开发体验。