(PHP 4, PHP 5, PHP 7, PHP 8)
rename — 重命名一個(gè)文件或目錄
$oldname, string $newname, resource $context = ?): bool
嘗試把 oldname 重命名為
newname,必要時(shí)會(huì)在不同目錄間移動(dòng)。
如果重命名文件時(shí) newname 已經(jīng)存在,將會(huì)覆蓋掉它。
如果重命名文件夾時(shí)
newname 已經(jīng)存在,本函數(shù)將導(dǎo)致一個(gè)警告。
oldname原名
注意:
用于
oldname中的封裝協(xié)議必須和用于newname中的相匹配。
newname新的名字。
注意: 在 Windows 上,如果
newname已經(jīng)存在,它必須是可寫(xiě)的。 否則 rename() 將失敗,并導(dǎo)致E_WARNING。
context上下文流(context stream) resource。
成功時(shí)返回 true, 或者在失敗時(shí)返回 false。
示例 #1 rename() 例子
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>