php中的rename()函數(shù)是一個內(nèi)置函數(shù)，用于重命名文件或目錄。它嘗試用用戶指定的新名稱更改文件或目錄的舊名稱，并且在必要時可以在目錄之間移動。
如果用戶指定的新名稱已經(jīng)存在，rename()函數(shù)將覆蓋它。文件的舊名稱和用戶指定的新名稱作為參數(shù)發(fā)送給rename()函數(shù)，成功時返回true，失敗時返回false。
語法:
rename(oldname, newname, context)參數(shù)的使用:
php中的rename()函數(shù)接受三個參數(shù)。
oldname:它是一個強制性參數(shù)，指定文件或目錄的舊名稱。
newname:它是一個強制參數(shù)，指定文件或目錄的新名稱。
context:它是一個可選參數(shù)，指定流的行為。
返回值:
成功時返回true，失敗時返回false。
錯誤和異常
1.在重命名目錄時，如果新名稱已經(jīng)存在，則rename會生成一個警告。
2.oldname中使用的包裝器必須與newname中使用的包裝器匹配。
3.如果目標文件系統(tǒng)不允許對文件執(zhí)行chown()或chmod()系統(tǒng)調(diào)用，那么rename()函數(shù)可能會生成警告。
下面的程序演示了rename()函數(shù)。
假設有一個名為“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 ;
// 檢查文件是否已經(jīng)存在
if(file_exists($new_name))
{
echo 重命名$old_name時出錯 ;
}
else
{
if(rename( $old_name, $new_name))
{
echo 成功地將 $old_name 重命名為 $new_name ;
}
else
{
echo 具有相同名稱的文件已經(jīng)存在 ;
}
}
?>輸出：
成功地將gfg.txt重命名為newgfg.txt