ssh2_sftp_stat

(PECL ssh2 >= 0.9.0)

ssh2_sftp_stat — Stat a file on a remote filesystem

Description

function ssh2_sftp_stat(resource $sftp, string $path): array|false

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 and returns the same values.

Parameters

sftp
An SSH2 SFTP resource opened by ssh2_sftp().
path

Return Values

Returns an array of statistics for the given file on success or false on failure. See the documentation for stat() for details on the values which may be returned.

Examples

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'];
?>

See Also

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes 3 notes

up
0
gmmarcus at outlook dot my
11 years ago
Just to add further, that was for a php 5.3.5 box running a 64 bit linux os....
i havent tested on other versions yet.

But there is quite a lot of noise about this in php bug list.
up
0
gmmarcus at outlook dot my
11 years ago
Pls note that stat does not seem to give proper filesizes even with 64 bit php if files > 2Gb
up
0
Darren Wolfe
14 years ago
As with stat(), the returned size of the file may be wrong if it is over 2GB.
＋add a note