# ssh2_exec

(PECL ssh2 >= 0.9.0)

ssh2_exec — Exécute une commande sur un serveur distant

### Description

ssh2_exec(
resource `$session`,
string `$command`,
string `$pty` = ?,
array `$env` = ?,
int `$width` = 80,
int `$height` = 25,
int `$width_height_type` = SSH2_TERM_UNIT_CHARS
): resource|false

Exécute une commande sur un serveur distant.

### Liste de paramètres

`session`

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

`command`

`pty`

`env`

  `env` peut être passé sous la forme d'un tableau associatif de paires nom/valeur, à définir dans l'environnement cible.

`width`

  Largeur du terminal virtuel.

`height`

  Hauteur du terminal virtuel.

`width_height_type`

  `width_height_type` peut valoir `SSH2_TERM_UNIT_CHARS` ou `SSH2_TERM_UNIT_PIXELS`.

### Valeurs de retour

Retourne un flux 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_exec($connection, '/usr/local/bin/php -i');
?>`

### Voir aussi

- ssh2_connect() - Connexion à un serveur SSH
- ssh2_shell() - Demande un shell interactif
- ssh2_tunnel() - Ouvre un tunnel à travers un serveur distant