Renames a file or directory

# rename

(PHP 4, PHP 5, PHP 7)

rename — Renames 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.

`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.

### Istoricul schimbărilor

Versiune | Descriere
--- | ---
5.3.1 | rename() can now rename files across drives in Windows.
5.0.0 | rename() can now also be used with some URL wrappers. Refer to Supported Protocols and Wrappers for a listing of which wrappers support rename().
4.3.3 | rename() may now be able to rename files across partitions on *nix based systems, provided the appropriate permissions are held. Warnings may be generated if the destination filesystem doesn't permit chown() or chmod() system calls to be made on files — for example, if the destination filesystem is a FAT filesystem.

### Exemple

Example #1 Example with rename()

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

### A se vedea și

- copy() - Copies file
- unlink() - Deletes a file
- move_uploaded_file() - Moves an uploaded file to a new location