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

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

Beispiel

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

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

Ergebnis der Codeausführung:

phptrue

Beispiel

Verschieben wir eine Datei in ein anderes Verzeichnis:

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

Ergebnis der Codeausführung:

phptrue

Beispiel

Versuchen wir, eine nicht existierende Datei umzubenennen:

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

Ergebnis der Codeausführung:

phpfalse

Beispiel

Benennen wir ein Verzeichnis um:

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

Ergebnis der Codeausführung:

phptrue

Siehe auch