Edit Report a Bug

    ftp_fput

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

    ftp_fput — Carica un file aperto sul server FTP

    Descrizione

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

    ftp_fput() carica i dati del file cui fa riferimento il puntatore handle fino a quando viene raggiunta la fine del file. I risultati sono salvati in remote_file sul server FTP. Il modo di trasferimento mode specificato deve essere FTP_ASCII oppure FTP_BINARY.

    Example #1 Esempio di funzione ftp_fput()

    <?php

    // apre in lettura un qualche file
    $file = 'somefile.txt';
    $fp = fopen($file, 'r');

    // stabilisce la connessione
    $conn_id = ftp_connect($ftp_server);

    // si collega con nome utente e password
    $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

    // prova a caricare $file
    if (ftp_fput($conn_id, $file, $fp, FTP_ASCII)) {
    echo     "$file caricato con successo\n";
    } else {
    echo     "Problemi con il caricamento di $file\n";
    }

    // chiude la connessione e l'handle del file
    ftp_close($conn_id);
    fclose($fp);

    ?>

    Nota:

    Il parametro startpos e' stato aggiunto in PHP 4.3.0.

    Restituisce true in caso di successo, false in caso di fallimento.

    Vedere anche ftp_put(), ftp_nb_fput(), e ftp_nb_put().

    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