ftp_rename

(PHP 4, PHP 5, PHP 7)

ftp_rename — Benennt eine Datei auf dem FTP-Server um

Beschreibung

ftp_rename ( resource $ftp_stream , string $oldname , string $newname ) : bool

ftp_rename() benennt eine Datei oder ein Verzeichnis auf dem FTP_Server um.

Parameter-Liste

ftp_stream: Der Verbindungshandler der FTP-Verbindung.
oldname: Der alte Datei-/Verzeichnisname.
newname: Der neue Name.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Im Fehlerfall (wie dem Versuch eine nicht exisitierende Datei umzubenennen) wird ein E_WARNING Fehler erzeugt.

Beispiele

Beispiel #1 ftp_rename()-Beispiel


<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';

// Verbindung aufbauen
$conn_id = ftp_connect($ftp_server);

// Login mit Benutzername und Passwort
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// Versuche $old_file in $new_file umzubenennen
if (ftp_rename($conn_id, $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($conn_id);
?>