PHP中的rename()函數是內建函數,用於重新命名檔案或目錄。它嘗試用使用者指定的新名稱更改檔案或目錄的舊名稱,並且在必要時可以在目錄之間移動。
如果使用者指定的新名稱已經存在,rename()函數將會覆寫它。檔案的舊名稱和使用者指定的新名稱會作為參數傳送給rename()函數,成功時傳回True,失敗時傳回False。
語法:
rename(oldname, newname, context)
參數的使用:
PHP中的rename()函數接受三個參數。
oldname:它是一個強制性參數,指定檔案或目錄的舊名稱。
newname:它是一個強制參數,指定檔案或目錄的新名稱。
context:它是一個可選參數,指定流的行為。
傳回值:
成功時傳回True,失敗時回傳False。
錯誤與例外
1.在重新命名目錄時,如果新名稱已經存在,則rename會產生警告。
2.oldname中使用的包裝器必須與newname中使用的包裝器相符。
3.如果目標檔案系統不允許對檔案執行chown()或chmod()系統調用,那麼rename()函數可能會產生警告。
下面的程式示範了rename()函數。
假設有一個名為「gfg.txt」的檔案
程式碼範例1:
<?php $old_name = "gfg.txt" ; $new_name = "newgfg.txt" ; rename( $old_name, $new_name) ; ?>
輸出:
1
程式碼範例2:
<?php $old_name = "gfg.txt" ; $new_name = "newgfg.txt" ; // 检查文件是否已经存在 if(file_exists($new_name)) { echo "重命名$old_name时出错" ; } else { if(rename( $old_name, $new_name)) { echo "成功地将 $old_name 重命名为 $new_name" ; } else { echo "具有相同名称的文件已经存在" ; } } ?>
輸出:
成功地将gfg.txt重命名为newgfg.txt
相關推薦:《PHP教學》
以上是PHP rename函數使用詳解(php重命名檔)的詳細內容。更多資訊請關注PHP中文網其他相關文章!