array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ftp-alloc.php', 1 => 'ftp_alloc', 2 => 'Aloca espaço para um arquivo ser carregado', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'Funções da extensão FTP', ), 'prev' => array ( 0 => 'ref.ftp.php', 1 => 'Funções da extensão FTP', ), 'next' => array ( 0 => 'function.ftp-append.php', 1 => 'ftp_append', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ftp/functions/ftp-alloc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ftp_alloc

(PHP 5, PHP 7, PHP 8)

ftp_alloc — Aloca espaço para um arquivo ser carregado

Descrição

ftp_alloc(FTP\Connection $ftp, int $size, string &$response = null): bool

Envia um comando ALLO ao servidor FTP remoto para alocar espaço para o envio de um arquivo.

Nota:

Muitos servidores FTP não suportam este comando. Esses servidores podem retornar um código de falha (false) indicando que o comando não é suportado ou um código de sucesso (true) para indicar que a pré-alocação não é necessária e o cliente deve continuar como se a operação tivesse sido bem-sucedida. Por causa disso, talvez seja melhor reservar esta função para servidores que exijam pré-alocação explícita.

Parâmetros

ftp

Uma instância de FTP\Connection.

size

O número de bytes a serem alocados.

response

Uma representação textual da resposta do servidor será retornada por referência em response se uma variável for fornecida.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro ftp agora espera uma instância de FTP\Connection; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de ftp_alloc()

<?php

$file = "/home/user/myfile";

// conectando ao servidor
$ftp = ftp_connect('ftp.example.com');
$login_result = ftp_login($ftp, 'anonymous', 'user@example.com');

if (ftp_alloc($ftp, filesize($file), $result)) {
echo "Espaço no servidor alocado com sucesso. Enviando $file.\n";
ftp_put($ftp, '/incoming/myfile', $file, FTP_BINARY);
} else {
echo "Não foi possível alocar espaço no servidor. Informação do servidor: $result\n";
}

ftp_close($ftp);

?>

Veja Também