array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.ssh2-shell-resize.php', 1 => 'ssh2_shell_resize', 2 => 'Change the dimensions of a channel\'s pseudo-terminal', ), 'up' => array ( 0 => 'ref.ssh2.php', 1 => 'SSH2 函数', ), 'prev' => array ( 0 => 'function.ssh2-shell.php', 1 => 'ssh2_shell', ), 'next' => array ( 0 => 'function.ssh2-tunnel.php', 1 => 'ssh2_tunnel', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/ssh2/functions/ssh2-shell-resize.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ssh2_shell_resize

(PECL ssh2 >= 1.4)

ssh2_shell_resize — Change the dimensions of a channel's pseudo-terminal

说明

function ssh2_shell_resize(
    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.

注意:

The extension declares only the first three parameters, under the name session for channel. As a result, width_px and height_px can only be passed positionally.

参数

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.

返回值

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.

错误／异常

An E_WARNING is emitted when channel is not an SSH channel stream.

示例

示例 #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);
?>

参见