# ftp_mkdir

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

ftp_mkdir — Crée un dossier sur un serveur FTP

### Description

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

ftp_mkdir() crée le dossier nommé `directory` sur le serveur FTP.

### Liste de paramètres

`ftp`

  Une instance de FTP\Connection.

`directory`

  Le nom du dossier qui doit être créé.

### Valeurs de retour

Retourne le nom du dossier créé en cas de succès ou `false` si une erreur survient.

### Erreurs / Exceptions

Émet une erreur de niveau `E_WARNING` si le dossier existe déjà ou les permissions concernées empêche la création du dossier.

### Historique

Version | Description
--- | ---
8.1.0 | La paramètre `ftp` attend désormais une instance de FTP\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple avec ftp_mkdir()

`<?php
$dir = 'www';
// Mise en place d'une connexion basique
$ftp = ftp_connect($ftp_server);
// Identication avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// Tentative de création du dossier $dir
if (ftp_mkdir($ftp, $dir)) {
echo "Le dossier $dir a été créé avec succès\n";
} else {
echo "Il y a eu un problème lors de la création du dossier $dir\n";
}
// Fermeture de la connexion
ftp_close($ftp);
?>`

### Voir aussi

- ftp_rmdir() - Efface un dossier FTP