Метод rename

Метод rename класса Filesystem переименовывает файл или директорию. Первым параметром передаётся исходный путь, вторым - новый путь. Если целевой файл уже существует, метод перезапишет его. Метод возвращает новый путь к переименованному файлу или директории.

Синтаксис

public function rename(string $origin, string $target, bool $overwrite = false): string

Пример

Давайте переименуем файл 'article.txt' в 'user.txt':

<?php
	namespace AppController;

	use SymfonyBundleFrameworkBundleControllerAbstractController;
	use SymfonyComponentHttpFoundationResponse;
	use SymfonyComponentFilesystemFilesystem;

	class ArticleController extends AbstractController
	{
		public function index(): Response
		{
			$fs = new Filesystem();
			$res = $fs->rename('article.txt', 'user.txt');

			return new Response($res);
		}
	}
?>

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

"user.txt"

Пример

Давайте переименуем директорию 'article' в 'user':

<?php
	namespace AppController;

	use SymfonyBundleFrameworkBundleControllerAbstractController;
	use SymfonyComponentHttpFoundationResponse;
	use SymfonyComponentFilesystemFilesystem;

	class ArticleController extends AbstractController
	{
		public function index(): Response
		{
			$fs = new Filesystem();
			$res = $fs->rename('article', 'user');

			return new Response($res);
		}
	}
?>

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

"user"

Пример

Давайте переименуем файл с перезаписью существующего целевого файла, передав третий параметр true:

<?php
	namespace AppController;

	use SymfonyBundleFrameworkBundleControllerAbstractController;
	use SymfonyComponentHttpFoundationResponse;
	use SymfonyComponentFilesystemFilesystem;

	class ArticleController extends AbstractController
	{
		public function index(): Response
		{
			$fs = new Filesystem();
			$res = $fs->rename('article.txt', 'user.txt', true);

			return new Response($res);
		}
	}
?>

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

"user.txt"

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

класс Filesystem,
который предоставляет методы для работы с файлами
метод copy,
который копирует файлы и директории
метод remove,
который удаляет файлы и директории
метод exists,
который проверяет существование файла или директории