PHP Function Reference

PHP ftp_mkdir() Function



The PHP ftp_mkdir() function creates the specified directory on the FTP server. This function returns the newly created directory name on success or false on error.

Syntax

ftp_mkdir(ftp, directory)

Parameters

ftp Required. Specify the FTP connection to use.
directory Required. Specify the name of the directory to create.

Return Value

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

Exceptions

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

Example:

The example below shows the usage of ftp_mkdir() function.

<?php
//FTP server to use
$ftp_server = "ftp.example.com";
 
//username for the FTP Connection
$ftp_user = "user";
  
//password for the user
$ftp_pass = "password";
  
//set up a connection or die 
$ftp = ftp_connect($ftp_server)
    or die("Could not connect to $ftp_server");
   
if($ftp) {
  echo "Successfully connected to $ftp_server!\n";
 
  //trying to login
  if(@ftp_login($ftp, $ftp_user, $ftp_pass)) {
    echo "Connected as $ftp_user@$ftp_server\n";

    $dir = "php";

    //trying to create the $dir directory
    if (ftp_mkdir($ftp, $dir)) {
      echo "Successfully created $dir directory\n";
    } else {
      echo "Error while creating $dir\n";
    }
    
  } else {
    echo "Couldn't connect as $ftp_user\n";
  }
 
  //close the connection
  if(ftp_close($ftp)) {
    echo "Connection closed successfully!\n"; 
  } 
}
?>

The output of the above code will be:

Successfully connected to ftp.example.com!
Connected as user@ftp.example.com
Successfully created php directory
Connection closed successfully!

❮ PHP FTP Reference