FTP_ALLOC(3)								 1							      FTP_ALLOC(3)

ftp_alloc - Allocates space for a file to be uploaded

SYNOPSIS

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

DESCRIPTION

	Sends an ALLO command to the remote FTP server to allocate space for a file to be uploaded.

       Note

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

PARAMETERS

	      o $ftp_stream
		- The link identifier of the FTP connection.

	      o $filesize
		- The number of bytes to allocate.

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

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      ftp_alloc(3) 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.
";
		ftp_put($conn_id, '/incomming/myfile', $file, FTP_BINARY);
	      } else {
		echo "Unable to allocate space on server.  Server said: $result
";
	      }

	      ftp_close($conn_id);

	      ?>

SEE ALSO

       ftp_put(3), ftp_fput(3).

PHP Documentation Group 													      FTP_ALLOC(3)