ssh2_sftp_mkdir()函数—用法及示例

函数名称：ssh2_sftp_mkdir()

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

用法：bool ssh2_sftp_mkdir(resource $sftp, string $dirname [, int $mode = 0777 [, bool $recursive = false]])

说明：ssh2_sftp_mkdir() 函数用于在远程服务器上创建一个新的目录。

参数：

• $sftp：一个已经建立的 SSH2 SFTP 资源连接。
• $dirname：要创建的目录的路径。
• $mode：可选参数，指定新目录的访问权限，默认为 0777（最高权限）。
• $recursive：可选参数，指定是否递归创建目录。如果设置为 true，则会创建所有不存在的父目录，默认为 false。

返回值：成功时返回 true，失败时返回 false。

示例：

<?php
// 建立 SSH 连接
$connection = ssh2_connect('example.com', 22);
ssh2_auth_password($connection, 'username', 'password');

// 建立 SFTP 连接
$sftp = ssh2_sftp($connection);

// 创建新目录
$dirname = "/path/to/new/directory";
if (ssh2_sftp_mkdir($sftp, $dirname, 0755, true)) {
    echo "目录创建成功！";
} else {
    echo "目录创建失败！";
}
?>

以上示例中，首先通过 ssh2_connect() 函数建立 SSH 连接，并使用 ssh2_auth_password() 函数进行身份验证。然后，通过 ssh2_sftp() 函数建立 SFTP 连接。

接下来，使用 ssh2_sftp_mkdir() 函数创建一个新目录。如果创建成功，将输出"目录创建成功！"，否则输出"目录创建失败！"。在示例中，我们指定了路径为 "/path/to/new/directory"，并设置了权限为 0755，同时启用了递归创建目录的选项。

请注意，为了使用 ssh2_sftp_mkdir() 函数，需要安装并启用 PECL ssh2 扩展。