Forum PHP 2026 - Paris (France)

ssh2_shell_resize

(PECL ssh2 >= 1.4)

ssh2_shell_resizeChange 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

add a note

User Contributed Notes

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