ssh2_shell_resize
(PECL ssh2 >= 1.4)
ssh2_shell_resize — Change the dimensions of a channel's pseudo-terminal
Description
resource
$channel,int
$width,int
$height,int
$width_px = 0,int
$height_px = 0): bool
Requests that the pseudo-terminal (PTY) attached to the given
channel be resized to the given dimensions.
Note:
The extension declares only the first three parameters, under the name
sessionforchannel. As a result,width_pxandheight_pxcan only be passed positionally.
Parameters
channel
An SSH channel stream, as returned by ssh2_exec() or ssh2_shell().
width
The width of the terminal, in characters.
height
The height of the terminal, in characters.
width_px
The width of the terminal in pixels, or 0 to leave
the pixel dimensions unspecified.
height_px
The height of the terminal in pixels, or 0 to leave
the pixel dimensions unspecified.
Return Values
Returns true, or false when channel is not an
SSH channel stream.
The outcome of the resize request itself is not reported: true is
returned even when the remote end does not honour it.
Errors/Exceptions
An E_WARNING is emitted when
channel is not an SSH channel stream.
Examples
Example #1 Resizing the pseudo-terminal of a shell
<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');
$shell = ssh2_shell($connection, 'xterm', null, 80, 24);
// Tell the remote end the terminal is now 132 columns by 43 rows
ssh2_shell_resize($shell, 132, 43);
?>See Also
- ssh2_shell() - Request an interactive shell
- ssh2_exec() - Execute a command on a remote server
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
