ftp_alloc

(PHP 5)

ftp_alloc -- Aloca espaço para um arquivo a ser enviado para o servidor (uploaded)

Descrição

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

Envia um commando ALLO para o servidor FTP para alocar espaçõ para que um arquivo seja enviado.

Nota: Muitos servidores FTP não suportam esse comando. Esses servidores podem retorna um código de falha (FALSE) indicando que o comando não é suportado ou um código de sucesso (TRUE) para indicar que pre-alocação não é necessário e o cliente deve continuar como se a operação tivesse sucedido. Por isso, talvez seja melhor usar essa função apenas em servidores que requerem pre-alocação explicitamente.

Parâmetros

ftp_stream

O link indentificado da conexão FTP.

filezise

O número de bytes a serem alocados.

return

Uma representação textual da resposta dos servidores será retornada por referência em result se uma variável for fornecida.

Valores de retornado

Retorna TRUE em caso de sucesso ou FALSE em falhas.

Exemplos

Exemplo 1. Um exemplo de ftp_alloc()

<?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);

?>

Veja também

ftp_put()
ftp_fput()