ssh2_shell_resize

(PECL ssh2 >= 1.4)

ssh2_shell_resize — Cambia 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

ssh2_shell() - Solicita un shell interactivo
ssh2_exec() - Ejecuta un comando en un servidor remoto