ssh2_shell_resize

(PECL ssh2 >= 1.4)

ssh2_shell_resize — Change les dimensions du pseudo-terminal d'un canal

Description

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

Demande que le pseudo-terminal (PTY) attaché au channel fourni soit redimensionné aux dimensions données.

Note:
L'extension ne déclare que les trois premiers paramètres, avec le nom session pour channel. Par conséquent, width_px et height_px ne peuvent être fournis que positionnellement.

Liste de paramètres

channel: Un flux de canal SSH, tel que retourné par ssh2_exec() ou ssh2_shell().
width: La largeur du terminal, en caractères.
height: La hauteur du terminal, en caractères.
width_px: La largeur du terminal en pixels, ou 0 pour laisser les dimensions en pixels non spécifiées.
height_px: La hauteur du terminal en pixels, ou 0 pour laisser les dimensions en pixels non spécifiées.

Valeurs de retour

Retourne true, ou false lorsque channel n'est pas un flux de canal SSH.

Le résultat de la demande de redimensionnement elle-même n'est pas rapporté: true est retourné même lorsque l'extrémité distante ne l'honore pas.

Erreurs / Exceptions

Une erreur de niveau E_WARNING est émise lorsque channel n'est pas un flux de canal SSH.

Exemples

Exemple #1 Redimensionnement du pseudo-terminal d'un shell

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

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

// Indique à l'extrémité distante que le terminal fait désormais 132 colonnes sur 43 lignes
ssh2_shell_resize($shell, 132, 43);
?>

Voir aussi

ssh2_shell() - Demande un shell interactif
ssh2_exec() - Exécute une commande sur un serveur distant