PHP函數介紹—rename(): 重新命名檔案或目錄

PHP函數介紹—rename(): 重新命名檔案或目錄

介紹：
在PHP中，rename()函數用來重新命名檔案或目錄。它提供了一種簡單的方法來更改檔案或目錄的名稱。無論是單一檔案還是整個目錄，都可以使用這個函數進行重新命名操作。透過指定來源檔案或目錄的名稱以及目標名稱，可以輕鬆完成重新命名過程。

語法：
bool rename ( string $source , string $target )

參數：

• $source：必要，表示原始檔案或目錄的名稱。
• $target：必需，表示目標檔案或目錄的名稱。

傳回值：
在成功時回傳TRUE，失敗時回傳FALSE。

範例：
以下是一些使用rename()函數的範例，來示範如何重新命名檔案和目錄。

1. 重新命名一個檔案：

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

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

在上面的範例中，我們將一個名為"old_file.txt"的檔案重新命名為"new_file.txt" 。如果重新命名成功，將輸出"檔案重新命名成功！"，否則輸出"檔案重新命名失敗！"。

2. 重新命名一個目錄：

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

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

在上面的範例中，我們將一個名為"old_directory"的目錄重新命名為"new_directory"。如果重新命名成功，將輸出"目錄重新命名成功！"，否則輸出"目錄重新命名失敗！"。

注意事項：

• rename()函數在執行時可能會受到檔案系統權限的限制。請確保您具有足夠的權限來更改檔案或目錄的名稱。
• 如果來源檔案或目錄不存在，rename()函數將傳回FALSE，表示重新命名失敗。

總結：
rename()函數是PHP中用來重新命名檔案或目錄的一個強大的函數。它允許您透過簡單地指定來源檔案或目錄的名稱以及目標名稱來變更檔案或目錄的名稱。使用範例程式碼，您可以輕鬆了解如何在您的PHP專案中使用rename()函數來實現檔案和目錄的重新命名操作。

以上是PHP函數介紹—rename(): 重新命名檔案或目錄的詳細內容。更多資訊請關注PHP中文網其他相關文章！