# ssh2_auth_password

(PECL ssh2 >= 0.9.0)

ssh2_auth_password — Authenticate over SSH using a plain password

### 说明

ssh2_auth_password ( resource `$session` , string `$username` , string `$password` ) : bool

Authenticate over SSH using a plain password. Since version 0.12 this function also supports keyboard_interactive method.

### 参数

`session`

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

`username`

  Remote user name.

`password`

  Password for `username`

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 范例

Example #1 Authenticating with a password

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

    if (ssh2_auth_password($connection, 'username', 'secret')) {
      echo "Authentication Successful!\n";
    } else {
      die('Authentication Failed...');
    }
    ?>