Функция rename

Функция rename переименовывает файл или директорию. Первым параметром функция принимает текущее имя файла или путь к нему, вторым параметром - новое имя или путь. Функция возвращает true в случае успеха и false в случае ошибки.

Синтаксис

rename(string $oldname, string $newname, resource $context = null): bool

Пример

Переименуем файл из 'old.txt' в 'new.txt':

<?php
	$res = rename('old.txt', 'new.txt');
	var_dump($res);
?>

Результат выполнения кода:

true

Пример

Переместим файл в другую директорию:

<?php
	$res = rename('file.txt', 'newdir/file.txt');
	var_dump($res);
?>

Результат выполнения кода:

true

Пример

Попробуем переименовать несуществующий файл:

<?php
	$res = rename('nonexistent.txt', 'new.txt');
	var_dump($res);
?>

Результат выполнения кода:

false

Пример

Переименуем директорию:

<?php
	$res = rename('olddir', 'newdir');
	var_dump($res);
?>

Результат выполнения кода:

true

Смотрите также

функцию copy,
которая копирует файл
функцию unlink,
которая удаляет файл
функцию move_uploaded_file,
которая перемещает загруженный файл