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