ftp_rename

(PHP 4, PHP 5, PHP 7)

ftp_renameBenennt 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);
?>