Функция rename

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

Синтаксис

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

Пример

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

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

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

phptrue

Пример

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

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

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

phptrue

Пример

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

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

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

phpfalse

Пример

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

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

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

phptrue

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

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