rename

(PHP 4, PHP 5)

rename — Rinomina un file o una directory

Descrizione

bool rename ( string $oldname , string $newname [, resource $context ] )

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().