ftp_mkdir()

Was ist ftp_mkdir()?

Die Funktion ftp_mkdir() ist eine in PHP integrierte Funktion, die ein neues Verzeichnis auf dem FTP-Server erstellt. Die Funktion nimmt zwei Parameter entgegen:

1. ftp_stream: Die Verbindungskennung, die von der Funktion ftp_connect() zurückgegeben wird.
2. directory: Der Name des zu erstellenden Verzeichnisses.

Die Funktion gibt true zurück, wenn das Verzeichnis erfolgreich erstellt wurde. Andernfalls gibt sie false zurück. Beachte, dass ftp_mkdir() keine verschachtelten Verzeichnisse erstellen kann; Zwischenpfade müssen manuell angelegt werden.

Syntax von ftp_mkdir()

Die Syntax der Funktion ftp_mkdir() lautet wie folgt:

Syntax von ftp_mkdir()

bool ftp_mkdir ( FTP\Connection $ftp_stream , string $directory )

Hinweis: Die typisierte Signatur oben erfordert PHP 8.0+. Die Funktion ist seit PHP 4.3.0 verfügbar.

Verwendung von ftp_mkdir()

Um die Funktion ftp_mkdir() zu verwenden, muss zunächst eine Verbindung zum FTP-Server über die Funktion ftp_connect() hergestellt und mit ftp_login() authentifiziert werden. Hier ist ein Beispiel:

Verwendung von ftp_mkdir()

<?php

// Set up an FTP connection
$conn = ftp_connect('ftp.example.com');

// Login with your FTP credentials
ftp_login($conn, 'username', 'password');

// Create a new directory
if (ftp_mkdir($conn, '/path/to/new/directory')) {
    echo "Directory created successfully.\n";
} else {
    echo "Failed to create directory.\n";
}

// Close the FTP connection
ftp_close($conn);

In diesem Beispiel wird eine Verbindung zum FTP-Server mithilfe der Funktion ftp_connect() hergestellt. Anschließend melden wir uns mit unseren FTP-Zugangsdaten über die Funktion ftp_login() an. Schließlich erstellen wir ein neues Verzeichnis mit der Funktion ftp_mkdir() und schließen die FTP-Verbindung.

Fehlerbehandlung bei ftp_mkdir()

Es ist wichtig, Fehler bei der Verwendung der Funktion ftp_mkdir() ordnungsgemäß zu behandeln. Gibt die Funktion false zurück, bedeutet dies, dass die Erstellung des Verzeichnisses fehlgeschlagen ist. Häufige Ursachen sind unzureichende Berechtigungen, ein ungültiger Pfad oder ein bereits vorhandenes Zielverzeichnis. Beachte, dass ftp_mkdir() fehlschlägt, wenn das angegebene Verzeichnis bereits existiert.

Hier ist ein Beispiel für die Fehlerbehandlung und die Konfiguration zuverlässiger FTP-Einstellungen:

Fehlerbehandlung bei ftp_mkdir()

<?php
if (ftp_mkdir($conn, '/path/to/new/directory')) {
    echo "Directory created successfully.\n";
} else {
    echo "Failed to create directory.\n";
    // Note: PHP's FTP extension does not expose the last server response directly.
    // Verify connection status, permissions, and path validity.
}
?>

Für zuverlässige FTP-Operationen sollte vor dem Erstellen von Verzeichnissen ein Timeout gesetzt und der passive Modus aktiviert werden:

ftp_set_option($conn, FTP_TIMEOUT_SEC, 30);
ftp_set_option($conn, FTP_USEPASVADDRESS, true);

Fazit

Die Funktion ftp_mkdir() bietet eine unkomplizierte Möglichkeit, Verzeichnisse auf einem FTP-Server zu erstellen. Denke daran, deine Verbindung zu validieren, Fehler kontrolliert zu behandeln, geeignete Timeouts zu setzen und Zwischenverzeichnisse bei Bedarf manuell zu erstellen. Durch die Anwendung dieser Praktiken lässt sich die FTP-Verzeichnisverwaltung zuverlässig in PHP-Anwendungen integrieren.

Verwandte Funktionen

Diese Funktionen werden häufig zusammen mit ftp_mkdir() beim Verwalten von Verzeichnissen über FTP verwendet:

• ftp_rmdir() — entfernt ein Verzeichnis vom FTP-Server.
• ftp_chdir() — wechselt das aktuelle Arbeitsverzeichnis auf dem Server.
• ftp_pwd() — gibt den aktuellen Verzeichnispfad zurück.
• ftp_set_option() — konfiguriert Optionen wie den Verbindungs-Timeout.
• ftp_pasv() — schaltet den passiven Modus um, der hinter Firewalls oft erforderlich ist.
• ftp_close() — schließt die FTP-Verbindung, wenn du fertig bist.

Übung