Forum PHP 2026 - Paris (France)

ssh2_shell_resize

(PECL ssh2 >= 1.4)

ssh2_shell_resizeCambia las dimensiones del pseudoterminal de un canal

Descripción

function ssh2_shell_resize(
    resource $channel,
    int $width,
    int $height,
    int $width_px = 0,
    int $height_px = 0
): bool

Solicita que el pseudoterminal (PTY) asociado al channel indicado se redimensione a las dimensiones dadas.

Nota:

La extensión solo declara los tres primeros parámetros, con el nombre session para channel. Por consiguiente, width_px y height_px solo pueden pasarse posicionalmente.

Parámetros

channel

Un flujo de canal SSH, tal como el devuelto por ssh2_exec() o ssh2_shell().

width

El ancho del terminal, en caracteres.

height

La altura del terminal, en caracteres.

width_px

El ancho del terminal en píxeles, o 0 para dejar sin especificar las dimensiones en píxeles.

height_px

La altura del terminal en píxeles, o 0 para dejar sin especificar las dimensiones en píxeles.

Valores devueltos

Devuelve true, o false cuando channel no es un flujo de canal SSH.

El resultado de la propia solicitud de redimensionado no se informa: se devuelve true incluso cuando el extremo remoto no la atiende.

Errores/Excepciones

Se emite un error de nivel E_WARNING cuando channel no es un flujo de canal SSH.

Ejemplos

Ejemplo #1 Redimensionado del pseudoterminal de un shell

<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');

$shell = ssh2_shell($connection, 'xterm', null, 80, 24);

// Indica al extremo remoto que el terminal tiene ahora 132 columnas por 43 filas
ssh2_shell_resize($shell, 132, 43);
?>

Véase también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top