rename
(PHP 4, PHP 5, PHP 7, PHP 8)
rename — 重新命名一個檔案或目錄
說明
rename(string
$oldname, string $newname, resource $context = ?): bool
嘗試把 oldname 重新命名為
newname，必要時會在不同目錄間移動。
如果重新命名檔案時 newname 已經存在，將會覆蓋掉它。
如果重新命名資料夾時
newname 已經存在，本函式將導致一個警告。
參數
-
oldname -
原名
注意:
用於
oldname中的封裝協議必須和用於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");
?>