ftp_rename

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

ftp_rename — 更改 FTP 服務(wù)器上的文件或目錄名

說明

ftp_rename(resource $ftp_stream, string $oldname, string $newname): bool

ftp_rename() 將 FTP 服務(wù)器上的一個(gè)文件或目錄改名。

參數(shù)

ftp_stream

FTP 連接的標(biāo)識符。

oldname

原來的文件／目錄名。

newname

新名字。

返回值

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。 失敗時(shí)（比如試圖重命名一個(gè)不存在的文件）將會拋出一個(gè) E_WARNING 錯(cuò)誤信息。

范例

示例 #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);
?>