downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

ftp_cdup> <FTP Functions
[edit] Last updated: Fri, 22 Jul 2011

view this page in

ftp_alloc

(PHP 5)

ftp_allocAllocates 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 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 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.

Parameters

ftp_stream

The link identifier of the FTP connection.

filesize

The number of bytes to allocate.

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() 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_idfilesize($file), $result)) {
  echo 
"Space successfully allocated on server.  Sending $file.\n";
  
ftp_put($conn_id'/incomming/myfile'$fileFTP_BINARY);
} else {
  echo 
"Unable to allocate space on server.  Server said: $result\n";
}

ftp_close($conn_id);

?>

See Also

  • ftp_put() - Uploads a file to the FTP server
  • ftp_fput() - Uploads from an open file to the FTP server



add a note add a note User Contributed Notes ftp_alloc
adams[AT]techweavers[DOT]net 21-Jun-2005 09:32
This function is nice but like the ftp_size function it too has a flaw if your file is larger then 2.1Gb or 2.1 Billion Btyes it cannot be properly allocated.

 
show source | credits | sitemap | contact | advertising | mirror sites