# ssh2_exec

(PECL ssh2 >= 0.9.0)

ssh2_exec — Execute a command on a remote server

### 说明

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

Execute a command at the remote end and allocate a channel for it.

### 参数

`session`

  An SSH connection link identifier, obtained from a call to ssh2_connect().

`command`

`pty`

`env`

  `env` may be passed as an associative array of name/value pairs to set in the target environment.

`width`

  Width of the virtual terminal.

`height`

  Height of the virtual terminal.

`width_height_type`

  `width_height_type` should be one of `SSH2_TERM_UNIT_CHARS` or `SSH2_TERM_UNIT_PIXELS`.

### 返回值

Returns a stream on success 或者在失败时返回 `FALSE`.

### 范例

Example #1 Executing a command

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

    $stream = ssh2_exec($connection, '/usr/local/bin/php -i');
    ?>

### 参见

- ssh2_connect() - Connect to an SSH server
- ssh2_shell() - Request an interactive shell
- ssh2_tunnel() - Open a tunnel through a remote server