   #PHP Manual FTP functions FTP functions ftp_cdup

   PHP Manual
   Prev  Next
   ______________________________________________________________________

                                   ftp_alloc

   (no version information, might be only in CVS)
   ftp_alloc -- Allocates space for a file to be uploaded.

Description

   bool ftp_alloc ( resource ftp_stream, int filesize [, string &result])

   Sends an ALLO command to the remote FTP server to allocate filesize
   bytes of space. Returns TRUE on success, or FALSE on failure.

     Note: Many FTP servers do not support this command. These servers
     may return a failure code (FALSE) indicating the command is not
     supported or a success code (TRUE) to indicate that pre-allocation
     is not necessary and the client should continue as though the
     operation were successful. Because of this, it may be best to
     reserve this function for servers which explicitly require
     preallocation.

   A textual representation of the servers response will be returned by
   reference in result is a variable is provided.

   Example 1. ftp_alloc() example
   <?php
   $file = "/home/user/myfile";
   /* connect to the server */
   $conn_id = ftp_connect('ftp.example.com');
   $login_result = ftp_login($conn_id, 'anonymous', 'user@example.com');
   if (ftp_alloc($conn_id, filesize($file), $result)) {
     echo "Space successfully allocated on server.  Sending $file.\n";
     ftp_put($conn_id, '/incomming/myfile', $file, FTP_BINARY);
   } else {
     echo "Unable to allocate space on server.  Server said: $result\n";
   }
   ftp_close($conn_id);
   ?>

   See also: ftp_put(), and ftp_fput().
   ______________________________________________________________________

   Prev          Home     Next
   FTP functions  Up  ftp_cdup
