# ssh2_shell

(PECL ssh2 >= 0.9.0)

ssh2_shell — Demande un shell interactif

### Description

ssh2_shell(
resource `$session`,
string `$termtype` = "vanilla",
?array `$env` = `null`,
int `$width` = 80,
int `$height` = 25,
int `$width_height_type` = SSH2_TERM_UNIT_CHARS
): resource|false

Ouvre un shell sur le serveur distant et lui alloue un flux.

### Liste de paramètres

`session`

  Un identifiant de connexion SSH, obtenu depuis la fonction ssh2_connect().

`termtype`

  `termtype` doit correspondre à une des entrées du fichier `/etc/termcap` du système cible.

`env`

  `env` doit être passé en tant qu'un tableau associatif de paire nom/valeur à définir dans l'environnement cible.

`width`

  Largeur du terminal virtuel.

`height`

  Hauteur du terminal virtuel.

`width_height_type`

  `width_height_type` doit être soit `SSH2_TERM_UNIT_CHARS`, soit `SSH2_TERM_UNIT_PIXELS`.

### Valeurs de retour

Retourne un flux de resource en cas de succès, ou `false` si une erreur survient.

### Exemples

Exemple #1 Exécution d'une commande

`<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');
$stream = ssh2_shell($connection, 'vt102', null, 80, 24, SSH2_TERM_UNIT_CHARS);
?>`

### Voir aussi

- ssh2_exec() - Exécute une commande sur un serveur distant
- ssh2_tunnel() - Ouvre un tunnel à travers un serveur distant
- ssh2_fetch_stream() - Parcours un flux étendu de données