Using PHP rename() Function to Rename Files and Directories

This article explains PHP's rename() function, detailing its syntax, parameters, return values, and usage examples for renaming both files and directories, while also highlighting important considerations such as permission constraints and error handling.

php Courses
php Courses
php Courses
Using PHP rename() Function to Rename Files and Directories

In PHP, the rename() function is used to rename a file or directory, providing a straightforward method to change its name by specifying the source and target names.

Syntax: bool rename ( string $source , string $target ) Parameters: $source: required, the name of the source file or directory. $target: required, the name of the destination file or directory.

Return value:

Returns TRUE on success and FALSE on failure.

Example – renaming a file:

<?php
$old_name = "old_file.txt";
$new_name = "new_file.txt";

if (rename($old_name, $new_name)) {
    echo "文件重命名成功!";
} else {
    echo "文件重命名失败!";
}
?>

Example – renaming a directory:

<?php
$old_name = "old_directory";
$new_name = "new_directory";

if (rename($old_name, $new_name)) {
    echo "目录重命名成功!";
} else {
    echo "目录重命名失败!";
}
?>

Note: The rename() function may be restricted by filesystem permissions; ensure you have sufficient rights. If the source file or directory does not exist, the function returns FALSE.

Summary: The rename() function is a powerful PHP tool for renaming files and directories, allowing developers to change names simply by providing source and target paths.

Original Source

Signed-in readers can open the original source through BestHub's protected redirect.

Sign in to view source
Republication Notice

This article has been distilled and summarized from source material, then republished for learning and reference. If you believe it infringes your rights, please contactadmin@besthub.devand we will review it promptly.

PHPdirectoryrename
php Courses
Written by

php Courses

php中文网's platform for the latest courses and technical articles, helping PHP learners advance quickly.

0 followers
Reader feedback

How this landed with the community

Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.