Edit Report a Bug

    ftp_fput

    (PHP 4, PHP 5, PHP 7)

    ftp_fput — Uploads from an open file to the FTP server

    Descrierea

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

    ftp_fput() uploads the data from a file pointer to a remote file on the FTP server.

    Parametri

    ftp_stream

    The link identifier of the FTP connection.

    remote_file

    The remote file path.

    handle

    An open file pointer on the local file. Reading stops at end of file.

    mode

    The transfer mode. Must be either FTP_ASCII or FTP_BINARY.

    startpos

    The position in the remote file to start uploading to.

    Valorile întoarse

    Întoarce valoarea true în cazul succesului sau false în cazul eșecului.

    Istoricul schimbărilor

    Versiune Descriere
    7.3.0 The mode parameter is now optional. Formerly it has been mandatory.

    Exemple

    Example #1 ftp_fput() example

    <?php

    // open some file for reading
    $file = 'somefile.txt';
    $fp = fopen($file, 'r');

    // 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 upload $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";
    }

    // close the connection and the file handler
    ftp_close($conn_id);
    fclose($fp);

    ?>

    A se vedea și

    • ftp_put() - Uploads a file to the FTP server
    • ftp_nb_fput() - Stores a file from an open file to the FTP server (non-blocking)
    • ftp_nb_put() - Stores a file on the FTP server (non-blocking)

    add a note add a note

    User Contributed Notes 10 notes

    up
    26
    roy at user dot nl
    11 years ago
    For directly inserting content into a file on an FTP host, you could also create a string stream wich streams directly to the ftp_fput function.

    This should create less overhead than first writing to any temp directories locally before streaming, as suggested here.

    <?php

    $string     = "Your content goes here";
    $stream = fopen('data://text/plain,' . $string,'r');

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

    ?>
    up
    2
    rok dot meglic at gmail dot com
    16 years ago
    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);
    ?>
    up
    4
    timgolding_10 at hotmail dot com
    15 years ago
    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
    up
    2
    jopi paranoid fi
    16 years ago
    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);

    ?>
    up
    0
    php at cpis dot me
    12 years ago
    This might be obvious to most of you, but make sure your stream isn't write-only. It has to be able to read from your stream in order to upload its contents.

    Took me a while trying to figure out why my  uploaded file was 0B, and that was why.
    up
    0
    jevin
    13 years ago
    You might also want to note that ftp_fput will overwrite any existing file.
    up
    1
    info at daniel-marschall dot de
    18 years ago
    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.
    up
    0
    robert b
    16 years ago
    Using jopi paranoid fi's example, tmpfile() works on PHP 4 and 5 instead of using the php://temp file.
    up
    0
    Charlie Brown
    16 years ago
    Fails if destination file exists. Delete first and it works.
    up
    -2
    darian lassan at yahoo de
    21 years ago
    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 add a note
    To Top