ssh2_sftp_mkdir

Create a directory

&reftitle.description; `bool` `ssh2_sftp_mkdir` `resource` `sftp` `string` `dirname` `int` `mode` 0777 `bool` `recursive`&false;

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.

&reftitle.parameters;

`sftp`

- An SSH2 SFTP resource opened by `ssh2_sftp`.

`dirname`

- Path of the new directory.

`mode`

- Permissions on the new directory. The actual mode is affected by the current umask.

`recursive`

- If `recursive` is &true; any parent directories required for `dirname` will be automatically created as well.

&reftitle.returnvalues;

&return.success;

&reftitle.examples;

### 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"); */
    ?>

&reftitle.seealso;

- `mkdir`
- `ssh2_sftp_rmdir`