PHP
Referenzliste
rename
Dateisystem-Funktionen
Befehl:
bool rename ( string $oldname , string $newname [, resource $context ] )
Parameter-Liste:
| Beschreibung | |
|---|---|
Der alte Name. Die in oldnameverwendet Wrapper müssen entsprechen den Wrapper in neuername. verwendet werden. | |
| Der neue Name. | |
Kontext-Unterstützung wurde mit PHP 5.0.0 eingeführt. Für eine Beschreibung von Zusammenhängen, um Streams zu verweisen. |
Rückgabewerte:
Gibt bei Erfolg
TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Beschreibung:
Mit rename() kann man versuchen, eine Datei (oldname) umzubenennen. Der neue Name steht im Parameter newname.
Wenn diese Funktion den Namen der Datei ändern konnte, gibt sie true zurück, sonst false.
Wenn diese Funktion den Namen der Datei ändern konnte, gibt sie true zurück, sonst false.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Siehe auch:
rename() - Beispiel:
Eingabe:
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>
Beschreibung:
| Beschreibung | |
|---|---|
| 5.3.1 | rename() können jetzt Dateien umbenennen über Laufwerke in Windows |
| 5.0.0 | rename() können nun auch mit einige URL-Wrapper verwendet werden. Siehe Unterstützte Protokolle and Wrappers für eine Liste von denen Wrapper unterstützen rename() |
| 4.3.3 | rename() kann nun in der Lage, Dateien auf Partitionen auf * nix-basierten Systemen umbenennen, sofern die entsprechenden Berechtigungen gehalten werden. Warnungen erzeugt, wenn der Zieldateisystem nicht chown() zu ermöglichen oder chmod() ruft System, um Dateien gemacht werden - zum Beispiel, wenn das Zieldateisystem ist ein FAT-Dateisystem. |
Dateisystem-Funktionen