# ssh2_sftp_stat

(PECL ssh2 >= 0.9.0)

ssh2_sftp_stat — Stat a file on a remote filesystem

### 说明

ssh2_sftp_stat ( resource `$sftp` , string `$path` ) : array

Stats a file on the remote filesystem following any symbolic links.

This function is similar to using the stat() function with the ssh2.sftp:// wrapper in PHP 5 and returns the same values.

### 参数

`sftp`

  An SSH2 SFTP resource opened by ssh2_sftp().

`path`

### 返回值

See the documentation for stat() for details on the values which may be returned.

### 范例

Example #1 Stating a file via SFTP

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

    $sftp = ssh2_sftp($connection);
    $statinfo = ssh2_sftp_stat($sftp, '/path/to/file');

    $filesize = $statinfo['size'];
    $group = $statinfo['gid'];
    $owner = $statinfo['uid'];
    $atime = $statinfo['atime'];
    $mtime = $statinfo['mtime'];
    $mode = $statinfo['mode'];
    ?>

### 参见

- ssh2_sftp_lstat() - Stat a symbolic link
- lstat() - 给出一个文件或符号连接的信息
- stat() - 给出文件的信息