You need to enable JavaScript to run this app. 基于XTerm.js与PHP WebSocket的应用无法动态控制终端尺寸
优惠活动
大模型
产品
解决方案
定价
更多

基于XTerm.js与PHP WebSocket的应用无法动态控制终端尺寸

XTerm.js终端动态尺寸适配方案

问题核心原因

  • 前端xterm-addon-fit仅修改了浏览器侧终端的渲染尺寸,未将变更同步到宿主端运行命令的伪终端(PTY)配置,依赖终端尺寸的应用始终读取PTY默认的24行80列参数
  • 前端发送的\e[8;H;Wt控制序列未被PTY层捕获处理,仅作为普通文本传递,无法触发尺寸修改
  • 单次执行stty rows xx cols xx无法联动前端resize事件,因此不能动态更新

落地实现步骤

  1. 前端捕获尺寸变更
    监听XTerm的resize事件(可直接基于xterm-addon-fit的回调触发),拿到调整后的实际行数、列数,通过WebSocket发送尺寸变更事件到PHP后端,数据格式参考:
    {"action":"resize","rows":30,"cols":120}
    
  2. 后端同步修改PTY配置
    PHP后端收到resize事件后,在对应会话绑定的PTY上下文下执行stty rows <实际行数> cols <实际列数>命令即可,不需要额外发送SIGWINCH信号,运行在该PTY下的进程会自动读取最新配置。
  3. 补全TTY分配配置
    若当前curl调用未分配伪终端,需要在curl启动参数中添加-t强制分配TTY,否则stty配置修改不会生效:
    curl -t <通信接口地址>
    

验证逻辑

窗口调整完成后执行stty size,返回的行、列数值需和当前XTerm渲染的实际尺寸一致,此时运行vim、无参ls等命令即可正常适配窗口大小。

内容的提问来源于stack exchange,提问作者Lukas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 16:54:03