rename

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

renameRenames a file or directory

Опис

rename(string $from, string $to, ?resource $context = null): bool

Attempts to rename from to to, moving it between directories if necessary. If renaming a file and to exists, it will be overwritten. If renaming a directory and to exists, this function will emit a warning.

Параметри

from

The old name.

Зауваження:

The wrapper used in from must match the wrapper used in to.

to

The new name.

Зауваження: On Windows, if to already exists, it must be writable. Otherwise rename() fails and issues E_WARNING.

context

resource контекст потоку.

Значення, що повертаються

Повертає true у разі успіху або false в разі помилки.

Приклади

Приклад #1 Example with rename()

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

Прогляньте також