# ssh2_sftp_mkdir

(PECL ssh2 >= 0.9.0)

ssh2_sftp_mkdir — Create a directory

### 说明

ssh2_sftp_mkdir ( resource `$sftp` , string `$dirname` [, int `$mode` = 0777 [, bool `$recursive` = `FALSE` ]] ) : bool

Creates a directory on the remote file server with permissions set to `mode`.

This function is similar to using mkdir() with the ssh2.sftp:// wrapper.

### 参数

`sftp`

  An SSH2 SFTP resource opened by ssh2_sftp().

`dirname`

  Path of the new directory.

`mode`

  Permissions on the new directory.

`recursive`

  If `recursive` is `TRUE` any parent directories required for `dirname` will be automatically created as well.

### 返回值

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

### 范例

Example #1 Creating a directory on a remote server

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

    ssh2_sftp_mkdir($sftp, '/home/username/newdir');
    /* Or:  mkdir("ssh2.sftp://$sftp/home/username/newdir"); */
    ?>

### 参见

- mkdir() - 新建目录
- ssh2_sftp_rmdir() - Remove a directory