rename

(PHP 4, PHP 5, PHP 7)

renameRenames a file or directory

Descrierea

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

Attempts to rename oldname to newname, moving it between directories if necessary. If renaming a file and newname exists, it will be overwritten. If renaming a directory and newname exists, this function will emit a warning.

Parametri

oldname

The old name.

Notă:

The wrapper used in oldname must match the wrapper used in newname.

newname

The new name.

Notă: On Windows, if newname already exists, it must be writable. Otherwise rename() fails and issues E_WARNING.

context

Notă: Susținrea contextelor a fost adăugată începând cu PHP 5.0.0. Pentru o descriere a contextelor, referiți-vă la Streams.

Valorile întoarse

Întoarce valoarea true în cazul succesului sau false în cazul eșecului.

Exemple

Example #1 Example with rename()

<?php
rename
("/tmp/tmp_file.txt""/home/user/login/docs/my_file.txt");
?>

A se vedea și