Definisi dan Penggunaan
Fungsi ftp_nb_get()
digunakan untuk mendapatkan (mengunduh) file dari server FTP, dan menyimpannya ke dalam file lokal (non-pemblokiran).
Tip: Fungsi ini (kebalikan dari ftp_get()
) yang dapat mengambil file secara asinkron, sehingga bisa melakukan operasi lain saat file sedang didownload.
Syntax
ftp_nb_get(ftp_conn, local_file, server_file, mode, startpos);
Nilai Parameter
Parameter | Deskripsi |
---|---|
ftp_conn | Required. Menentukan koneksi FTP yang akan digunakan |
local_file | Required. Menentukan jalur file lokal (akan ditimpa jika file sudah ada) |
server_file | Required. Menentukan file server yang akan disownload |
mode | Optional. Menentukan mode transfer. Nilai yang memungkinkan: FTP_ASCII atau FTP_BINARY |
startpos | Optional. Menentukan posisi dalam file jarak jauh untuk mulai mengunduh |
Detail Teknis
Return Value: | Salah satu nilai berikut: FTP_FAILED (kirim / terima gagal) FTP_FINISHED (kirim / terima selesai) FTP_MOREDATA (kirim / terima sedang berlangsung) |
---|---|
PHP Version: | 4.3+ |
PHP Changelog: | PHP 7.3 – Parameter mode dibuat opsional. |
Contoh
Unduh file dari server FTP, dan simpan ke file lokal (non-pemblokiran):
<?php // Koneksi dan login ke server FTP $ftp_server = "ftp.example.com"; $ftp_conn = ftp_connect($ftp_server) or die("Could not connect to $ftp_server"); $login = ftp_login($ftp_conn, $ftp_username, $ftp_userpass); $local_file = "local.zip"; $server_file = "server.zip"; // Mulai download $d = ftp_nb_get($ftp_conn, $local_file, $server_file, FTP_ASCII) while ($d == FTP_MOREDATA) { // Lakukan yang ingin dilakukan // Lanjutkan mendownload $d = ftp_nb_continue($ftp_conn); } if ($d != FTP_FINISHED) { echo "Error downloading $server_file"; exit(1); } // Tutup koneksi ftp_close($ftp_conn); ?>