函式名:ftp_fget()
函式功能:從FTP伺服器上下載一個檔案並儲存到本地檔案中
適用版本:PHP 4, PHP 5, PHP 7
語法:ftp_fget(resource $ftp_stream, resource $handle, string $remote_file, int $mode [, int $resumepos = 0])
引數說明:
- $ftp_stream:一個已經透過ftp_connect()函式建立的FTP連線資源
- $handle:要儲存檔案的本地檔案控制代碼,必須是透過fopen()函式開啟的檔案控制代碼
- $remote_file:要下載的遠端檔案的路徑
- $mode:檔案的開啟模式,可以是FTP_ASCII(文字模式)或FTP_BINARY(二進位制模式)
- $resumepos(可選):如果設定了這個引數,將會從指定的位置繼續下載檔案
返回值:
- 成功時返回true,失敗時返回false
示例程式碼:
// 連線到FTP伺服器
$conn = ftp_connect('ftp.example.com');
if (!$conn) {
die('無法連線到FTP伺服器');
}
// 登入到FTP伺服器
$login = ftp_login($conn, 'username', 'password');
if (!$login) {
die('登入失敗');
}
// 開啟本地檔案
$file = fopen('localfile.txt', 'w');
// 從FTP伺服器下載檔案
if (ftp_fget($conn, $file, '/path/to/remote/file.txt', FTP_BINARY)) {
echo '檔案下載成功';
} else {
echo '檔案下載失敗';
}
// 關閉本地檔案和FTP連線
fclose($file);
ftp_close($conn);
注意事項:
- 在使用ftp_fget()函式之前,必須先使用ftp_connect()函式建立FTP連線,並透過ftp_login()函式登入到FTP伺服器。
- 本地檔案必須透過fopen()函式開啟,並且必須有寫入許可權。
- 遠端檔案的路徑可以是相對路徑或絕對路徑。
- 執行成功後,可以透過fclose()函式關閉本地檔案和ftp_close()函式關閉FTP連線。