Как переименовать файл в PHP - лучшие практики и готовые примеры

Если файл находится в другой директории, удобнее использовать абсолютные пути. Пример:

$old = '/home/user/docs/report.txt';
$new = '/home/user/archive/report_2024.txt';
if (rename($old, $new)) {
    echo 'Файл перемещён и переименован.';
} else {
    echo 'Не удалось выполнить операцию.';
}
  

Php заменить файл (замена содержимого файла в php (перезапись))

Цель: одновременное перемещение и переименование. Функция rename() автоматически изменяет местоположение файла, если новый путь указывает на другую директорию. Проверка через if позволяет своевременно среагировать на ошибку.

PHP работает с файловыми именами как с последовательностями байт. Если имена содержат символы национальных алфавитов, необходимо учитывать кодировку файловой системы (обычно UTF-8). Пример:

$old = 'отчет.txt';
$new = 'отчет_2024.txt';
if (rename($old, $new)) {
    echo 'Файл с кириллическим именем переименован.';
} else {
    echo 'Ошибка: возможно проблема с кодировкой.';
}
  

Php получить имя файла (получение имени файла из пути в php)

В большинстве современных систем (Linux с UTF-8, Windows 10+) проблем не возникает. В старых версиях Windows или неправильно настроенных серверах может потребоваться преобразование имени в нужную кодировку функцией iconv() или mb_convert_encoding().

Простого возврата false недостаточно для диагностики. Лучше использовать комбинацию проверок и логирование. Пример:

$old = 'source.txt';
$new = 'destination.txt';
if (!file_exists($old)) {
    error_log('Исходный файл не существует: ' . $old);
    echo 'Файл не найден.';
} elseif (file_exists($new)) {
    error_log('Файл назначения уже существует: ' . $new);
    echo 'Невозможно переименовать: целевой файл занят.';
} elseif (!rename($old, $new)) {
    error_log('Не удалось переименовать: ' . $old . ' -> ' . $new);
    echo 'Ошибка операции.';
} else {
    echo 'Файл успешно переименован.';
}
  

Php информация о файле (получение информации о файле в php)

Цель: получить понятное сообщение о причине сбоя. Использование error_log() помогает отладке в production-среде.

Функция rename() не меняет метаданные файла (дату создания, модификации). Если требуется сохранить временные метки, дополнительных действий не требуется – они остаются неизменными. Пример:

$old = 'document.doc';
$new = 'document_renamed.doc';
$oldStat = stat($old);
if (rename($old, $new)) {
    touch($new, $oldStat['mtime'], $oldStat['atime']);
    echo 'Файл переименован, дата изменений сохранена.';
} else {
    echo 'Ошибка.';
}
  

Php переименовать файл (переименование файла в php)

Здесь сначала извлекается статистика старого файла (время последнего изменения и доступа), затем после переименования эти метки принудительно устанавливаются новому файлу с помощью touch(). Это полезно, если в процессе переименования требуется гарантировать идентичность метаданных.

Для обработки группы файлов используется цикл в сочетании с функциями glob() или scandir(). Пример – добавить префикс 'new_' ко всем .txt файлам в текущей папке:

$files = glob('*.txt');
foreach ($files as $file) {
    $newName = 'new_' . $file;
    if (rename($file, $newName)) {
        echo "$file -> $newName успешно переименован\n";
    } else {
        echo "Ошибка переименования $file\n";
    }
}
  

Цель: автоматизация переименования большого количества файлов. Важно избегать конфликтов имён, поэтому можно добавлять случайное число или временную метку.

Иногда rename() не работает на разных файловых системах (например, при попытке переместить файл между разделами диска). В такой ситуации можно применить последовательность: копировать, затем удалить оригинал. Пример:

$old = '/mnt/old/file.txt';
$new = '/mnt/new/renamed.txt';
if (copy($old, $new)) {
    if (unlink($old)) {
        echo 'Файл скопирован и удалён – эквивалент переименования.';
    } else {
        unlink($new); // откат
        echo 'Не удалось удалить оригинал.';
    }
} else {
    echo 'Не удалось скопировать файл.';
}
  

Цель: обход ограничения rename() для разных файловых систем (например, перемещение с одного диска на другой). Однако этот способ не атомарен и требует дополнительной проверки.