Funkcja rename

Funkcja rename zmienia nazwę pliku lub katalogu. Pierwszy parametr funkcji przyjmuje bieżącą nazwę pliku lub ścieżkę do niego, drugi parametr - nową nazwę lub ścieżkę. Funkcja zwraca true w przypadku sukcesu i false w przypadku błędu.

Składnia

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

Przykład

Zmieńmy nazwę pliku z 'old.txt' na 'new.txt':

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

Wynik wykonania kodu:

true

Przykład

Przenieśmy plik do innego katalogu:

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

Wynik wykonania kodu:

true

Przykład

Spróbujmy zmienić nazwę nieistniejącego pliku:

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

Wynik wykonania kodu:

false

Przykład

Zmieńmy nazwę katalogu:

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

Wynik wykonania kodu:

true

Zobacz też

funkcję copy,
która kopiuje plik
funkcję unlink,
która usuwa plik
funkcję move_uploaded_file,
która przenosi przesłany plik