# ssh2_scp_recv

(PECL ssh2 >= 0.9.0)

ssh2_scp_recv — Request a file via SCP

### 说明

ssh2_scp_recv ( resource `$session` , string `$remote_file` , string `$local_file` ) : bool

Copy a file from the remote server to the local filesystem using the SCP protocol.

### 参数

`session`

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

`remote_file`

  Path to the remote file.

`local_file`

  Path to the local file.

### 返回值

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

### 范例

Example #1 Downloading a file via SCP

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

    ssh2_scp_recv($connection, '/remote/filename', '/local/filename');
    ?>

### 参见

- ssh2_scp_send() - Send a file via SCP
- copy() - 拷贝文件