Forum und email
rename

rename

(PHP 3, PHP 4, PHP 5)

rename -- Renames a file or directory

Description

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

Attempts to rename oldname to newname.

Zwraca TRUE w przypadku sukcesu, FALSE w przypadku porażki.

Przykład 1. Example with rename()

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

Notatka: Prior to PHP 4.3.3, rename() could not rename files across partitions on *nix based systems.

Notatka: As of PHP 5.0.0 rename() can also be used with some URL wrappers. Refer to Dodatek M for a listing of which wrappers support rename().

Notatka: The wrapper used in oldname MUST match the wrapper used in newname.

Notatka: Wsparcie dla kontekstów zostało dodane w PHP 5.0.0. Opis kontekstów znajduje się w rozdziale Materiały źródłowe CLVIII, Stream Functions.

See also copy(), unlink(), and move_uploaded_file().