PHP Conference Nagoya 2025

    ftp_mkdir

    (PHP 4, PHP 5, PHP 7, PHP 8)

    ftp_mkdir — Creates a directory

    Description

    ftp_mkdir(FTP\Connection $ftp, string $directory): string|false

    Creates the specified directory on the FTP server.

    Parameters

    ftp

    An FTP\Connection instance.

    directory

    The name of the directory that will be created.

    Return Values

    Returns the newly created directory name on success or false on error.

    Errors/Exceptions

    Emits an E_WARNING level error if the directory already exists or the relevant permissions prevent creating the directory.

    Changelog

    Version Description
    8.1.0 The ftp parameter expects an FTP\Connection instance now; previously, a resource was expected.

    Examples

    Example #1 ftp_mkdir() example

    <?php

    $dir     = 'www';

    // set up basic connection
    $ftp = ftp_connect($ftp_server);

    // login with username and password
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // try to create the directory $dir
    if (ftp_mkdir($ftp, $dir)) {
    echo     "successfully created $dir\n";
    } else {
    echo     "There was a problem while creating $dir\n";
    }

    // close the connection
    ftp_close($ftp);
    ?>

    See Also

    Found A Problem?

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

    User Contributed Notes 4 notes

    up
    48
    PINAR Musa
    11 years ago
    Here's the correct code for making recursive directories:

    <?php

    // function
    function ftp_mksubdirs($ftpcon,$ftpbasedir,$ftpath){
    @    ftp_chdir($ftpcon, $ftpbasedir); // /var/www/uploads
    $parts = explode('/',$ftpath); // 2013/06/11/username
    foreach($parts as $part){
    if(!@    ftp_chdir($ftpcon, $part)){
    ftp_mkdir($ftpcon, $part);
    ftp_chdir($ftpcon, $part);
    //ftp_chmod($ftpcon, 0777, $part);
    }
    }
    }

    // usage
    $path_of_storage = '/var/www/uploads';
    $newftpdir = '2013/06/11/username';

    $conn_id = ftp_connect($ftpserver);
    ftp_login($conn_id, $login, $pass);
    ftp_mksubdirs($conn_id,$path_of_storage,$newftpdir);
    ftp_close($conn_id);

    ?>
    up
    1
    vladimir at lukianov dot name
    20 years ago
    For recurrent following function work better.
    Some ftp servers (like WarFTP) become demented if you'll
    try mkdir not from root dir and if path will be relative.
    The second if one of dir (like '/') already exist You'll get access denied.

    <?php
    function MkDir($path)
    {
    $dir=split("/", $path);
    $path="";
    $ret = true;

    for (    $i=0;$i<count($dir);$i++)
    {
    $path.="/".$dir[$i];
    echo     "$path\n";
    if(!@    ftp_chdir($this->conn_id,$path)){
    @    ftp_chdir($this->conn_id,"/");
    if(!@    ftp_mkdir($this->conn_id,$path)){
    $ret=false;
    break;
    }
    }
    }
    return     $ret;
    }
    ?>
    up
    0
    butch AT 4RealMedia dot com
    18 years ago
    When trying to user the ftp_mkdir, or ftp_chdir I've noticed that some servers like the entire path such as

    /usr/local/home/username/sitename/directory/

    and other servers, want you to use the path from the initial login, such as just /sitename/directory/

    Just wanted to pass this on
    up
    -1
    postmaster at 250union dot community
    6 years ago
    if(!@ftp_chdir($ftpcon, $part)){
    ftp_mkdir($ftpcon, $part);
    ftp_chdir($ftpcon, $part);
    //ftp_chmod($ftpcon, 0777, $part);
    }

    This if part of answer below, if you want working chmod you need to replace it with:

    if(!@ftp_chdir($ftpcon, $part)){
    ftp_mkdir($ftpcon, $part);
    ftp_chmod($ftpcon, 0777, $part);
    ftp_chdir($ftpcon, $part);
    }
    ＋add a note
    To Top