Manual do PHP
Anterior |  | Próxima

# 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()

Anterior | Principal | Próxima
FTP | Acima | ftp_cdup