ftp_fput

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

ftp_fput将打开的文件上传到 FTP 服务器

描述

ftp_fput(
    FTP\Connection $ftp,
    string $remote_filename,
    resource $stream,
    int $mode = FTP_BINARY,
    int $offset = 0
): bool

ftp_fput() 将数据从文件指针上传到 FTP 服务器上的远程文件。

参数

ftp

一个 FTP\Connection 实例。

remote_filename

远程文件路径。

stream

本地文件上的一个打开的文件指针。读取在文件末尾停止。

mode

传输模式。必须是 FTP_ASCIIFTP_BINARY

offset

远程文件开始上传的位置。

返回值

成功时返回 true,失败时返回 false

变更日志

版本 描述
8.1.0 ftp 参数现在需要一个 FTP\Connection 实例;之前,需要一个 资源
7.3.0 mode 参数现在是可选的。以前它是强制性的。

示例

示例 #1 ftp_fput() 示例

<?php

// 打开一个用于读取的文件
$file = 'somefile.txt';
$fp = fopen($file, 'r');

// 设置基本连接
$ftp = ftp_connect($ftp_server);

// 使用用户名和密码登录
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// 尝试上传 $file
if (ftp_fput($ftp, $file, $fp, FTP_ASCII)) {
echo
"成功上传 $file\n";
} else {
echo
"上传 $file 时出现问题\n";
}

// 关闭连接和文件句柄
ftp_close($ftp);
fclose($fp);

?>

参见

  • ftp_put() - 将文件上传到 FTP 服务器
  • ftp_nb_fput() - 将文件从打开的文件存储到 FTP 服务器(非阻塞)
  • ftp_nb_put() - 将文件存储在 FTP 服务器上(非阻塞)

添加注释

用户贡献的注释 10 条注释

28
roy at user dot nl
11 年前
要直接将内容插入 FTP 主机上的文件,您还可以创建一个字符串流,该流直接流向 ftp_fput 函数。

这应该比先写入任何本地临时目录,然后再进行流式传输(如这里所建议)产生更少的开销。

<?php

$string
= "您的内容在此";
$stream = fopen('data://text/plain,' . $string,'r');

ftp_fput($this->connection,$pathTo,$stream, FTP_BINARY);

?>
7
timgolding_10 at hotmail dot com
15 年前
如果您在使用 fput 时遇到以下错误之一

警告:ftp_fput() [function.ftp-fput]:正在打开 ASCII 模式数据连接

警告:ftp_fput() [function.ftp-fput]:正在打开二进制模式数据连接

并且它在正确的位置创建了文件,但它是一个 0kb 文件,并且此后的所有 FTP 命令都失败了。这很可能是因为客户端位于防火墙后面。要解决此问题,请使用

<?php
ftp_pasv
($resource, true);
?>

在执行任何 put 命令之前。我花了很长时间才弄明白这一点,实际上当我弄明白的时候,我欢呼雀跃 :D
3
jopi paranoid fi
16 年前
当您将文件内容作为字符串时,创建一个临时流,并将其用作文件句柄。

<?php

$contents
= "这是一个测试文件\n测试 1,2,3..";

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

ftp_fput($this->ftp, $filename, $tempHandle, FTP_ASCII);

?>
1
rok dot meglic at gmail dot com
15 年前
确保在使用 ftp_put 之前,您已切换到远程目录,否则 ftp_put 将返回无法创建文件的错误。在执行 chdir 后,您不应将文件的完整路径传递给 ftp_put,而应只传递基本名称(文件名)。有关更多信息,请参见示例。

示例
<?php
$locpath
= 'local_path/resources/js/test.js';
$rempath = 'resources/js/';
$remFile = 'test.js';

ftp_chdir($this->conn_id, $rempath);
ftp_put($this->conn_id, $remFile, $locpath, FTP_BINARY);
?>
0
php at cpis dot me
12 年前
这对于你们中的大多数人来说可能很明显,但要确保您的流不是只写流。它必须能够从您的流中读取,才能上传其内容。

我花了一段时间才弄明白为什么我上传的文件是 0B,这就是原因。
0
jevin
12 年前
您可能还想注意的是,ftp_fput 将覆盖任何现有的文件。
0
robert b
15 年前
使用 jopi paranoid fi 的示例,tmpdir() 在 PHP 4 和 5 上有效,而不是使用 php://temp 文件。
0
Charlie Brown
16 年前
如果目标文件存在,则会失败。先删除,然后就可以工作了。
0
info at daniel-marschall dot de
18 年前
这是一个我编写的将整个目录复制到 FTP 服务器文件夹的函数。

function ftp_uploaddirectory($conn_id, $local_dir, $remote_dir)
{
@ftp_mkdir($conn_id, $remote_dir);
$handle = opendir($local_dir);
while (($file = readdir($handle)) !== false)
{
if (($file != '.') && ($file != '..'))
{
if (is_dir($local_dir.$file))
{
ftp_uploaddirectory($conn_id, $local_dir.$file.'/', $remote_dir.$file.'/');
}
else
$f[] = $file;
}
}
closedir($handle);
if (count($f))
{
sort($f);
@ftp_chdir($conn_id, $remote_dir);
foreach ($f as $files)
{
$from = @fopen("$local_dir$files", 'r');
@ftp_fput($conn_id, $files, $from, FTP_BINARY);
}
}
}

示例

$conn_id = @ftp_connect($server);
@ftp_login ($conn_id, $username, $passwort);
ftp_uploaddirectory($conn_id, 'mydirectory/', 'theftpdirectory/');
@ftp_quit($conn_id);

我希望您会发现它有用。
-3
darian lassan at yahoo de
21 年前
如果您想传递一个包含文件名作为源而不是资源句柄的字符串,请使用 ftp_put()。 琐碎但在这里没有提到。
To Top