rename

(PHP 3, PHP 4 , PHP 5)

rename -- Rinomina un file

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.

Esempio 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 Appendice L 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().