ftp_rename
(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_rename — 更改 FTP 伺服器上的檔案或目錄名
說明
ftp_rename(resource
$ftp_stream, string $oldname, string $newname): boolftp_rename() 將 FTP 伺服器上的一個檔案或目錄改名。
參數
-
ftp_stream -
FTP 連線的識別符號。
-
oldname -
原來的檔案／目錄名。
-
newname -
新名字。
返回值
成功時返回 true， 或者在失敗時返回 false。 失敗時（比如試圖重新命名一個不存在的檔案）將會拋出一個 E_WARNING 錯誤資訊。
範例
示例 #1 ftp_rename() 例子
<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';
// set up basic connection
$conn_id = ftp_connect($ftp_server);
// login with username and password
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
// try to rename $old_file to $new_file
if (ftp_rename($conn_id, $old_file, $new_file)) {
echo "successfully renamed $old_file to $new_file\n";
} else {
echo "There was a problem while renaming $old_file to $new_file\n";
}
// close the connection
ftp_close($conn_id);
?>