ftp_rename
(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_rename — Benennt eine Datei auf dem FTP-Server um
Beschreibung
ftp_rename() benennt eine Datei oder ein Verzeichnis auf dem FTP_Server um.
Parameter-Liste
-
ftp
-
Eine FTP\Connection-Instanz.
-
from
-
Der alte Datei-/Verzeichnisname.
-
to
-
Der neue Name.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben. Im Fehlerfall (wie dem Versuch, eine nicht exisitierende
Datei umzubenennen) wird ein E_WARNING
-Fehler erzeugt.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter ftp erwartet nun eine
FTP\Connection-Instanz; vorher wurde eine Ressource
erwartet.
|
Beispiele
Beispiel #1 ftp_rename()-Beispiel
<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';
// Verbindung aufbauen
$ftp = ftp_connect($ftp_server);
// Login mit Benutzername und Passwort
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// Versuche $old_file in $new_file umzubenennen
if (ftp_rename($ftp, $old_file, $new_file)) {
echo "$old_file erfolgreich in $new_file umbenannt\n";
} else {
echo "Ein Fehler trat beim Umbenennen von $old_file in $new_file auf\n";
}
// Verbindung schließen
ftp_close($ftp);
?>