ssh2_sftp_lstat()函数—用法及示例

函数名：ssh2_sftp_lstat()

适用版本：PHP 5 >= 5.2.0, PECL ssh2 >= 0.10

用法：ssh2_sftp_lstat(resource $sftp, string $path)

说明：ssh2_sftp_lstat() 函数用于获取SFTP服务器上指定文件或目录的文件信息，返回一个关联数组表示文件的统计信息。

参数：

• $sftp：SFTP连接资源，通过ssh2_sftp()函数获取。
• $path：要获取信息的文件或目录的路径。

返回值：成功时返回关联数组，包含以下元素：

• 'size'：文件大小，以字节为单位。
• 'uid'：文件所有者的用户ID。
• 'gid'：文件所属组的组ID。
• 'permissions'：文件权限，以八进制表示。
• 'atime'：文件最后访问时间的时间戳。
• 'mtime'：文件最后修改时间的时间戳。

示例：

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

$sftp = ssh2_sftp($connection);
$fileInfo = ssh2_sftp_lstat($sftp, '/path/to/file.txt');

echo "文件大小：" . $fileInfo['size'] . " 字节\n";
echo "文件所有者的用户ID：" . $fileInfo['uid'] . "\n";
echo "文件所属组的组ID：" . $fileInfo['gid'] . "\n";
echo "文件权限：" . decoct($fileInfo['permissions']) . "\n";
echo "文件最后访问时间：" . date('Y-m-d H:i:s', $fileInfo['atime']) . "\n";
echo "文件最后修改时间：" . date('Y-m-d H:i:s', $fileInfo['mtime']) . "\n";

以上示例中，首先通过ssh2_connect()函数建立SSH连接，然后使用ssh2_auth_password()函数进行身份验证。接下来，使用ssh2_sftp()函数获取SFTP连接资源。最后，使用ssh2_sftp_lstat()函数获取指定文件的文件信息，并将返回的关联数组打印出来。

注意：在使用ssh2_sftp_lstat()函数之前，需要确保已经成功建立SSH连接并进行了身份验证。