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