rename

(PHP 4, PHP 5, PHP 7, PHP 8)

rename重命名一個文件或目錄

說明

rename(string $oldname, string $newname, resource $context = ?): bool

嘗試把 oldname 重命名為 newname,必要時會在不同目錄間移動。 如果重命名文件時 newname 已經存在,將會覆蓋掉它。 如果重命名文件夾時 newname 已經存在,本函數(shù)將導致一個警告。

參數(shù)

oldname

原名

注意:

用于 oldname 中的封裝協(xié)議必須和用于 newname 中的相匹配。

newname

新的名字。

注意: 在 Windows 上,如果 newname 已經存在,它必須是可寫的。 否則 rename() 將失敗,并導致 E_WARNING。

context

上下文流(context stream) resource。

返回值

成功時返回 true, 或者在失敗時返回 false。

范例

示例 #1 rename() 例子

<?php
rename
("/tmp/tmp_file.txt""/home/user/login/docs/my_file.txt");
?>

參見