PHP - Manual: ftp_fget

2024-11-14

ftp_fget

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_fget — 从 FTP 服务器上下载一个文件并保存到本地一个已经打开的文件中

说明

ftp_fget(
    resource $ftp_stream,
    resource $handle,
    string $remote_file,
    int $mode,
    int $resumepos = 0
): bool

ftp_fget() 函数用来下载由 remote_file 指定的文件，并写入到本地已经被打开的一个文件中。

参数

ftp_stream: FTP 连接的链接标识符。
handle: 本地已经打开的文件的句柄。
remote_file: 远程文件的路径。
mode: 传送模式参数，必须是 (文本模式) FTP_ASCII 或 (二进制模式) FTP_BINARY 中的一个。
resumepos: 远程文件开始下载的位置。

返回值

成功时返回 true，或者在失败时返回 false。

范例

示例 #1 ftp_fget() 例子


<?php

// path to remote file
$remote_file = 'somefile.txt';
$local_file = 'localfile.txt';

// open some file to write to
$handle = fopen($local_file, 'w');

// set up basic connection
$conn_id = ftp_connect($ftp_server);

// login with username and password
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// try to download $remote_file and save it to $handle
if (ftp_fget($conn_id, $handle, $remote_file, FTP_ASCII, 0)) {
 echo "successfully written to $local_file\n";
} else {
 echo "There was a problem while downloading $remote_file to $local_file\n";
}

// close the connection and the file handler
ftp_close($conn_id);
fclose($handle);
?>

更新日志

版本	说明
4.3.0	增加了`resumepos` 的支持。

参见

ftp_get() - 从 FTP 服务器上下载一个文件
ftp_nb_get() - 从 FTP 服务器上获取文件并写入本地文件（non-blocking）
ftp_nb_fget() - 从 FTP 服务器获取文件并写入到一个打开的文件（非阻塞）

add a note

User Contributed Notes 6 notes

down

broom at alturnanetworks dot com ¶

13 years ago


Another ftp_get_contents approach, using a temperary stream handler. Returns file contents as string. 


<?php

function ftp_get_contents ($conn_id, $filename,

//Create temp handler:

    $tempHandle = fopen('php://temp', 'r+');


//Get file from FTP assuming that it exists:

    ftp_fget($conn_id, $tempHandle, $filename, FTP_ASCII, 0));


    //Getting detailed stats to check filesize:

    $fstats = fstat($tempHandle);


    return fread($tempHandle, $fstats['size']);

}

?>

down

broom at alturnanetworks dot com ¶

13 years ago


<?php

/** 

 * Function returns contents via FTP connection and returns it as string (right version...)

 */

function ftp_get_contents ($conn_id, $filename) {

    //Create temp handler:

    $tempHandle = fopen('php://temp', 'r+');

    

    //Get file from FTP:

    if (@ftp_fget($conn_id, $tempHandle, $filename, FTP_ASCII, 0)) {

        rewind($tempHandle);

        return stream_get_contents($tempHandle);

    } else {

        return false;

    }

}

?>

down

mike at eastghost dot com ¶

9 years ago


You might need to use ftp_pasv() if you're behind a firewall and receiving odd timeouts, file creation but now local data saving, etc.

down

-1

lionskape at gmail dot com ¶

5 years ago


if you are using windows ftp-server with cp1251 encoding there are some troubles with russian "я" in filename\path.

php use telnet to connect ftp-server and there are special symbol with code 255 in telnet protocol. You can try use ftp_raw($connection, 'OPTS UTF8 ON'); and work in utf-8 (if server provides it).

P.S. sorry for my bad english

down

-2

justrafi at gmail dot com ¶

14 years ago


I was in need to synchronize two folders on two separate servers, one is a Windows server, and the other is a Linux server. I created this short and sweet function to help me do this. PLEASE NOTICE: This will not copy folders, and probably will fail if remote folder contains anything else than files.

function sync_folders($host, $port, $username, $password, $remote_dir, $local_dir, $passive_mode = true) {
    $conn_id = ftp_connect($host, $port);
    if (!$conn_id) return false; # fail to connect
    if (!ftp_login($conn_id, $username, $password)) { ftp_close($conn_id); return false; }  # fail to login
    ftp_pasv($conn_id, $passive_mode);
    if (!ftp_chdir($conn_id, $remote_dir)) { ftp_close($conn_id); return false; } # fail to change dir
    if (substr($local_dir, -1) != '/') $local_dir .= '/';

    $list = ftp_nlist($conn_id, '.');
    sort($list);
    foreach ($list as $file) {
        if (!file_exists($local_dir . $file)) {
            $is_copied = ftp_get($conn_id, $local_dir . $file, $file, FTP_BINARY);
        }
    }
    ftp_close($conn_id);
    return true;
}

down

-2

rodrigo-rocha at oi dot net dot br ¶

19 years ago


If you suply only a filename to the second parameter of function the ftp_get will open a pointer to the local file creating it and write to it.It's ok if your server dont execute for to mutch time and you dont get too many files but if you do it too many times the pointers created by ftp_get will not be closed and will end your opened files capacity at your server making it to do not open any more files until you restart it.

add a note

官方地址：https://www.php.net/manual/en/function.ftp-fget.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP获取指定函数定义在哪个文件中及行号 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像 adodb连接mysql多个数据库的问题常用的php ADODB使用方法集锦

略微加速

PHP官方手册 - 互联网笔记

ftp_fget

说明

参数

返回值

范例

更新日志

参见

User Contributed Notes 6 notes