PHP Conference Japan 2024

ftp_fput

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

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

描述

ftp_fput(
    FTP\Connection $ftp,
    字符串 $remote_filename,
    资源 $stream,
    整数 $mode = FTP_BINARY,
    整数 $offset = 0
): 布尔值

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 个笔记

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);

?>
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
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);

?>
rok dot meglic at gmail dot com
16 年前
确保在使用 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);
?>
php at cpis dot me
12 年前
这对你们中的大多数人来说可能是显而易见的,但请确保您的流不是只写流。它必须能够从您的流中读取才能上传其内容。

我花了一段时间才弄清楚为什么我上传的文件是 0B,这就是原因。
jevin
13年前
您可能还需要注意,ftp_fput 会覆盖任何现有文件。
robert b
16 年前
使用 jopi paranoid fi 的示例,tmpfile() 在 PHP 4 和 5 上工作,而不是使用 php://temp 文件。
Charlie Brown
16 年前
如果目标文件存在则失败。先删除,然后它就可以工作了。
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);

希望您觉得它有用。
darian lassan at yahoo de
21年前
如果您想传递一个包含文件名作为源的字符串而不是资源句柄,请使用 ftp_put()。微不足道,但这里没有提到。
To Top