PHP rename() 函数教程：如何重命名文件和目录

M66 2025-06-12

PHP rename() 函数介绍

在PHP中，rename()函数用于重命名文件或目录。通过此函数，您可以轻松修改文件或目录的名称。无论是文件还是目录，rename()都提供了便捷的方式来更改名称。通过传入源名称和目标名称，重命名操作就能顺利完成。

语法

bool rename ( string $source , string $target )

参数说明：

$source：必需，指定要重命名的源文件或目录名称。
$target：必需，指定新的目标名称。

返回值：

成功时返回 TRUE，失败时返回 FALSE。

示例代码

以下是使用rename()函数重命名文件和目录的示例代码：

示例 1: 重命名文件

该示例展示了如何将文件从 "old_file.txt" 重命名为 "new_file.txt"。

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

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

在上面的示例中，我们使用 rename() 函数将文件重命名。如果操作成功，将输出 "文件重命名成功！"；否则输出 "文件重命名失败！"。

示例 2: 重命名目录

以下示例展示了如何将目录 "old_directory" 重命名为 "new_directory"。

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

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

在这个示例中，我们通过 rename() 函数将目录名称从 "old_directory" 改为 "new_directory"。若成功，系统会显示 "目录重命名成功！"；否则会显示 "目录重命名失败！"。

注意事项

文件系统权限：执行rename()时，可能会受到文件系统权限的限制。请确保您有足够的权限来修改文件或目录的名称。
源文件或目录存在性：如果源文件或目录不存在，rename()函数将返回 FALSE，表示重命名失败。

总结

PHP中的rename()函数是一个非常强大的工具，它允许用户通过简单的代码将文件或目录名称修改为新的名称。无论是在文件操作还是目录管理中，rename()函数都提供了极大的便利。掌握了这个函数，您将能轻松实现文件和目录的重命名操作。

rename