rename

(PHP 4, PHP 5, PHP 7, PHP 8)

renameRinomina un file o una directory

Descrizione

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

Tenta di rinominare oldname in newname.

Restituisce true in caso di successo, false in caso di fallimento.

Example #1 Esempio di uso di rename()

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

Nota:

Nelle versioni di PHP precedenti alla 4.3.3, la funzione rename() non può rinominare file attraverso partizioni nei sistemi *nix.

Nota: Dal PHP 5.0.0 rename() può anche essere utilizzata con qualche wrapper URL. Fare riferimento a Supported Protocols and Wrappers per avere l'elenco dei wrapper supportati da rename().

Nota: Il wrapper utilizzato per oldname DEVE essere il medesimo utilizzato per newname.

Nota: Il parametro context è stato aggiunto in PHP 5.0.0.

Vedere anche copy(), unlink() e move_uploaded_file().