ftp_get()函式—用法及示例

函式名：ftp_get()

適用版本：PHP 4 >= 4.0.3, PHP 5, PHP 7

用法：ftp_get() 函式用於從 FTP 伺服器下載檔案到本地計算機。它接受一個已經建立連線的 FTP 連線資源和兩個檔名引數作為輸入，將遠端檔案下載到本地檔案。

語法：bool ftp_get ( resource $ftp_stream , string $local_file , string $remote_file , int $mode = FTP_BINARY [, int $resumepos = 0 ] )

引數：

1. ftp_stream：FTP 連線資源，透過 ftp_connect() 或 ftp_ssl_connect() 函式獲取。
2. local_file：本地檔案路徑，用於儲存下載的檔案。
3. remote_file：遠端檔案路徑，指定要下載的檔案。
4. mode：可選引數，指定傳輸模式。預設為 FTP_BINARY，表示二進位制傳輸模式，也可以設定為 FTP_ASCII，表示 ASCII 傳輸模式。
5. resumepos：可選引數，指定繼續傳輸的位置，預設為 0，表示從檔案的開頭開始傳輸。

返回值：成功時返回 true，失敗時返回 false。

示例：

// 建立 FTP 連線
$ftp_server = 'ftp.example.com';
$ftp_user = 'username';
$ftp_pass = 'password';
$conn = ftp_connect($ftp_server);
ftp_login($conn, $ftp_user, $ftp_pass);

// 下載遠端檔案到本地
$local_file = '/path/to/local/file.txt';
$remote_file = '/path/to/remote/file.txt';
if (ftp_get($conn, $local_file, $remote_file, FTP_BINARY)) {
    echo "檔案下載成功！";
} else {
    echo "檔案下載失敗！";
}

// 關閉 FTP 連線
ftp_close($conn);

以上示例中，我們首先建立了與 FTP 伺服器的連線，然後使用ftp_get()函式將遠端檔案"/path/to/remote/file.txt"下載到本地檔案"/path/to/local/file.txt"中。如果下載成功，將輸出"檔案下載成功！"，否則輸出"檔案下載失敗！"。最後，我們關閉了與 FTP 伺服器的連線。

請注意，為了使用ftp_get()函式，你需要在 PHP 的配置檔案中啟用FTP擴充套件（extension=ftp）或者在編譯 PHP 時啟用FTP擴充套件模組。