Funktion rename

Die Funktion rename benennt eine Datei oder ein Verzeichnis um. Der erste Parameter der Funktion ist der aktuelle Dateiname oder Pfad, der zweite Parameter - der neue Name oder Pfad. Die Funktion gibt true bei Erfolg und false bei einem Fehler zurück.

Syntax

rename(string $oldname, string $newname, resource $context = null): bool

Beispiel

Benennen wir die Datei von 'old.txt' in 'new.txt' um:

<?php
	$res = rename('old.txt', 'new.txt');
	var_dump($res);
?>

Ergebnis der Codeausführung:

true

Beispiel

Verschieben wir eine Datei in ein anderes Verzeichnis:

<?php
	$res = rename('file.txt', 'newdir/file.txt');
	var_dump($res);
?>

Ergebnis der Codeausführung:

true

Beispiel

Versuchen wir, eine nicht existierende Datei umzubenennen:

<?php
	$res = rename('nonexistent.txt', 'new.txt');
	var_dump($res);
?>

Ergebnis der Codeausführung:

false

Beispiel

Benennen wir ein Verzeichnis um:

<?php
	$res = rename('olddir', 'newdir');
	var_dump($res);
?>

Ergebnis der Codeausführung:

true

Siehe auch

die Funktion copy,
die eine Datei kopiert
die Funktion unlink,
die eine Datei löscht
die Funktion move_uploaded_file,
die eine hochgeladene Datei verschiebt