ftp_nb_fget

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

ftp_nb_fget — 從 FTP 服務(wù)器獲取文件并寫入到一個(gè)打開(kāi)的文件（非阻塞）

說(shuō)明

ftp_nb_fget(
    resource $ftp_stream,
    resource $handle,
    string $remote_file,
    int $mode = FTP_IMAGE,
    int $resumepos = 0
): int

ftp_nb_fget() 從遠(yuǎn)程 FTP 服務(wù)器獲取一個(gè)文件

本函數(shù)和 ftp_fget() 函數(shù)的區(qū)別是 本函數(shù)是異步方式獲取文件的， 所以在下載文件的過(guò)程中你的程序還可以執(zhí)行其他操作。

參數(shù)

ftp_stream

FTP 連接標(biāo)示符。

handle

用來(lái)存儲(chǔ)數(shù)據(jù)的一個(gè)已經(jīng)打開(kāi)的文件句柄。

remote_file

遠(yuǎn)程文件路徑。

mode

傳輸模式，必須是 FTP_ASCII 或者 FTP_BINARY。

resumepos

遠(yuǎn)程文件開(kāi)始下載的位置（即從遠(yuǎn)程文件的哪個(gè)字節(jié)開(kāi)始下載）。

返回值

返回 FTP_FAILED 或 FTP_FINISHED 或 FTP_MOREDATA。

更新日志

版本 說(shuō)明
7.3.0 參數(shù) mode 變?yōu)榭蛇x參數(shù)。 在之前的版本中，這是一個(gè)必填參數(shù)。

范例

示例 #1 ftp_nb_fget() 函數(shù)例程

<?php

// 打開(kāi)要寫入的文件
$file = 'index.php';
$fp = fopen($file, 'w');

$conn_id = ftp_connect($ftp_server);

$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// 初始化下載
$ret = ftp_nb_fget($conn_id, $fp, $file, FTP_BINARY);
while ($ret == FTP_MOREDATA) {

   // 其他要做的工作
   echo ".";

   // 繼續(xù)下載...
   $ret = ftp_nb_continue($conn_id);
}
if ($ret != FTP_FINISHED) {
   echo "There was an error downloading the file...";
   exit(1);
}

// 關(guān)閉文件句柄
fclose($fp);
?>

參見(jiàn)

  • ftp_nb_get() - 從 FTP 服務(wù)器上獲取文件并寫入本地文件（non-blocking）
  • ftp_nb_continue() - 連續(xù)獲取／發(fā)送文件（以不分塊的方式 non-blocking）
  • ftp_fget() - 從 FTP 服務(wù)器上下載一個(gè)文件并保存到本地一個(gè)已經(jīng)打開(kāi)的文件中
  • ftp_get() - 從 FTP 服務(wù)器上下載一個(gè)文件