Συνάρτηση 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,
που μετακινεί ένα ανεβασμένο αρχείο