函式名:ftp_append()
適用版本:PHP 4 >= 4.3.0, PHP 5, PHP 7
用法:ftp_append() 函式用於將資料追加到遠端 FTP 伺服器上的檔案中。它透過 FTP 協議將資料寫入檔案的末尾。
語法:bool ftp_append(resource $ftp_stream, string $remote_file, string $local_file, int $mode = FTP_BINARY)
引數:
- $ftp_stream:FTP 連線的資源識別符號,透過 ftp_connect() 或 ftp_ssl_connect() 函式獲得。
- $remote_file:遠端 FTP 伺服器上的目標檔案路徑。
- $local_file:本地檔案的路徑,即要追加到遠端檔案的資料。
- $mode:可選引數,指定傳輸模式,預設為 FTP_BINARY(二進位制模式)。
返回值:成功時返回 true,失敗時返回 false。
示例:
$ftp_server = 'ftp.example.com';
$ftp_user = 'username';
$ftp_pass = 'password';
// 建立 FTP 連線
$conn = ftp_connect($ftp_server);
if (!$conn) {
die('無法連線到 FTP 伺服器');
}
// 登入 FTP 伺服器
if (!ftp_login($conn, $ftp_user, $ftp_pass)) {
die('無法登入到 FTP 伺服器');
}
// 開啟本地檔案
$local_file = 'path/to/local/file.txt';
$handle = fopen($local_file, 'r');
if (!$handle) {
die('無法開啟本地檔案');
}
// 追加檔案到遠端伺服器
$remote_file = '/path/to/remote/file.txt';
if (ftp_append($conn, $remote_file, $local_file)) {
echo '檔案追加成功';
} else {
echo '檔案追加失敗';
}
// 關閉連線和檔案控制代碼
ftp_close($conn);
fclose($handle);
注意事項:
- 在使用 ftp_append() 函式之前,需要先建立 FTP 連線並登入到 FTP 伺服器。
- 要追加的本地檔案必須已經存在且可讀。
- 遠端檔案必須具有寫許可權,否則追加操作將失敗。
- 如果追加成功,原始檔案將被修改,新資料將被新增到檔案的末尾。
- 如果追加失敗,可能是由於網路連線問題或許可權限制造成的,需要根據具體情況進行排查。