Last updated: Fri, 13 Nov 2009

ftp_fput

(PHP 4, PHP 5)

ftp_fput — オープン中のファイルを FTP サーバにアップロードする

説明

bool ftp_fput ( resource $ftp_stream , string $remote_file , resource $handle , int $mode [, int $startpos = 0 ] )

ftp_fput() は、ファイルポインタが指すデータを FTP サーバ上のリモートファイルへアップロードします。

パラメータ

ftp_stream: FTP 接続のリンク ID 。
remote_file: リモートファイルのパス。
handle: ローカルでオープンされているファイルのポインタ。ファイルの終端まで進むと読み込みが終了します。
mode: 転送モード。FTP_ASCII または FTP_BINARY のどちらかを指定する必要があります。
startpos

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例

例1 ftp_fput() の例


<?php

// ファイルを読み込みモードで開く
$file = 'somefile.txt';
$fp = fopen($file, 'r');

// 接続を確立する
$conn_id = ftp_connect($ftp_server);

// ユーザ名とパスワードでログインする
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// $file のアップロードを試みる
if (ftp_fput($conn_id, $file, $fp, FTP_ASCII)) {
    echo "Successfully uploaded $file\n";
} else {
    echo "There was a problem while uploading $file\n";
}

// 接続を閉じ、ファイルを閉じる
ftp_close($conn_id);
fclose($fp);

?>

変更履歴

バージョン	説明
4.3.0	`startpos` が追加されました。

参考

ftp_put() - FTP サーバにファイルをアップロードする
ftp_nb_fput() - オープン中のファイルを FTP サーバに保存する（非ブロッキング）
ftp_nb_put() - FTP サーバにファイルを保存する（非ブロッキング）

ftp_get_option

ftp_fget

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
ftp_fput

timgolding_10 at hotmail dot com
26-Apr-2009 02:48


If when using fput you get the one of the following errors:



Warning: ftp_fput() [function.ftp-fput]: Opening ASCII mode data connection



Warning: ftp_fput() [function.ftp-fput]: Opening BINARY mode data connection



and it creates the file in the correct location but is a 0kb file and all FTP commands thereafter fail. It is likely that the client is behind a firewall. To rectify this use:



<?php

ftp_pasv($resource, true);

?>



Before executing any put commands. Took me so long to figure this out I actually cheered when I did :D

rok dot meglic at gmail dot com
07-Nov-2008 12:35


Make sure you chdir to remote directory before using ftp_put or else ftp_put will just return error that it cannot create file. After you do the chdir you should NOT pass the whole path of file to ftp_put but just basename (filename). See example for more info.



Example:

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

?>

robert b
12-Sep-2008 09:43


Using jopi paranoid fi's example, tmpfile() works on PHP 4 and 5 instead of using the php://temp file.

jopi paranoid fi
20-May-2008 07:57


When you have your file contents as a string, create temporary stream and use that as a file handle.



<?php



$contents = "This is a test file\nTesting 1,2,3..";



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

fwrite($tempHandle, $contents);

rewind($tempHandle);        



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



?>

Charlie Brown
16-Apr-2008 09:19


Fails if destination file exists. Delete first and it works.

info at daniel-marschall dot de
19-Apr-2006 07:04


This is a function i wrote to copy a complete directory to a FTP-Server-folder.



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

    }

  }

}



Example:



$conn_id = @ftp_connect($server);

@ftp_login ($conn_id, $username, $passwort);

ftp_uploaddirectory($conn_id, 'mydirectory/', 'theftpdirectory/');

@ftp_quit($conn_id);



I hope you'll find it useful.

BobFrank <rsfranc at yahoo dot com dot br>
24-Aug-2003 04:10


FTP upload server 2 server

<?php

$FTP_HOST ="ftp.br.geocities.com"; 

$FTP_USER ="bobfrank";

$FTP_PW   ="mypasswd";

$FTP_ROOT_DIR="/";

$LOCAL_SERVER_DIR  = "images/";

$FTP_DIR = "mydir/";

$handle=opendir($LOCAL_SERVER_DIR);

while (($file = readdir($handle))!==false)

{

    if(!is_dir($file)){

        $f[]="$file";        

      }

}

closedir($handle);

sort($f);

$count=0;

$mode = FTP_BINARY; // or FTP_ASCII

$conn_id = ftp_connect($FTP_HOST); 

if(ftp_login($conn_id, $FTP_USER, $FTP_PW)){

    print "from: ".$LOCAL_SERVER_DIR."<br>";

    print "to: ".$FTP_HOST.$FTP_ROOT_DIR.$FTP_DIR."<br>";

    ftp_pwd($conn_id);

    ftp_mkdir($conn_id,$FTP_DIR);

    ftp_chdir($conn_id,$FTP_DIR); 

    foreach($f as $files) {

        $from = fopen($LOCAL_SERVER_DIR.$files,"r");     

        if(ftp_fput($conn_id, $files, $from, $mode)){

            $count +=1;

            print $files."<br>";

        }

    }

    ftp_quit($conn_id);

}

print "upload : $count files.";

?>

darian lassan at yahoo de
04-Feb-2003 06:00


If you want to pass a string containing the filename as source and not a resource handle use ftp_put() instead. Trivial but not mentioned here.

add a note

ftp_get_option

ftp_fget

Last updated: Fri, 13 Nov 2009