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