ftp_mkdir()
Was ist ftp_mkdir()?
Die Funktion ftp_mkdir() ist eine integrierte PHP-Funktion, die ein neues Verzeichnis auf dem FTP-Server erstellt. Die Funktion erwartet zwei Parameter:
- ftp_stream: Die Verbindungs-ID, die von der Funktion ftp_connect() zurückgegeben wird.
- 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. Beachten Sie, dass ftp_mkdir() keine verschachtelten Verzeichnisse erstellen kann; Zwischenpfade müssen manuell erstellt 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 oben gezeigte typisierte Signatur 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, müssen Sie zunächst eine Verbindung zum FTP-Server mit der Funktion ftp_connect() herstellen. 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 stellen wir eine Verbindung zum FTP-Server mit der Funktion ftp_connect() her. Anschließend melden wir uns mit unseren FTP-Zugangsdaten über die Funktion ftp_login() an. Abschließend erstellen wir ein neues Verzeichnis mit der Funktion ftp_mkdir() und schließen die FTP-Verbindung.
Fehlerbehandlung in ftp_mkdir()
Es ist wichtig, Fehler bei der Verwendung der Funktion ftp_mkdir() ordnungsgemäß zu behandeln. Wenn die Funktion false zurückgibt, bedeutet dies, dass die Verzeichniserstellung fehlgeschlagen ist. Häufige Gründe sind unzureichende Berechtigungen, ein ungültiger Pfad oder dass das Zielverzeichnis bereits existiert. Beachten Sie, dass ftp_mkdir() fehlschlägt, wenn das angegebene Verzeichnis bereits existiert.
Hier ist ein Beispiel, wie Sie Fehler behandeln und zuverlässige FTP-Einstellungen konfigurieren können:
Fehlerbehandlung in 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 sollten Sie vor dem Erstellen von Verzeichnissen ein Timeout festlegen und den Passivmodus aktivieren:
ftp_set_option($conn, FTP_TIMEOUT_SEC, 30);
ftp_set_option($conn, FTP_USEPASVADDRESS, true);Fazit
Die Funktion ftp_mkdir() bietet einen einfachen Weg, Verzeichnisse auf einem FTP-Server zu erstellen. Denken Sie daran, Ihre Verbindung zu überprüfen, Fehler angemessen zu behandeln, angemessene Timeouts festzulegen und bei Bedarf Zwischenverzeichnisse manuell zu erstellen. Die Anwendung dieser Praktiken hilft Ihnen, das FTP-Verzeichnismanagement zuverlässig in Ihre PHP-Anwendungen zu integrieren.
Practice
Was ist die Hauptfunktion von ftp_mkdir() in PHP?