ftp_set_option

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

ftp_set_optionDefine opções diversas em tempo de execução

Descrição

ftp_set_option(FTP\Connection $ftp, int $option, int|bool $value): bool

Esta função controla várias opções em tempo de execução para a conexão FTP especificada.

Parâmetros

ftp

Uma instância de FTP\Connection.

option

Atualmente, as seguintes opções são suportadas:

Opção em tempo de execução do FTP suportada
FTP_TIMEOUT_SEC Muda o limite de tempo em segundos usado para todas as operações de rede relacionadas. value deve ser um inteiro maior que 0. O limite de tempo padrão é de 90 segundos.
FTP_AUTOSEEK Quando ativado, requisições GET ou PUT com um parâmetro resumepos ou startpos irão primeiro procurar a posição especificada no arquivo. Isto está ativado por padrâo.
FTP_USEPASVADDRESS Quando desabilitado, PHP irá ignorar o endereço IP retornado pelo servidor FTP em resposta do comando PASV, e no lugar usará o endereço IP que foi fornecido em ftp_connect(). value deve ser um booleano.
value

Este parâmetro depende de qual opção foi escolhida em option para ser alterada.

Valor Retornado

Retorna true se a opção pôde ser definida; false se não. Uma mesangem de alerta será emitida se a opção em option não for suportada ou se o parâmetro value informado não corresponder ao valor esperado para a opção informada em option.

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

Example #1 Exemplo de ftp_set_option()

<?php
// Define o limite de tempo da rede a 10 segundos
ftp_set_option($ftp, FTP_TIMEOUT_SEC, 10);
?>

Veja Também

  • ftp_get_option() - Obtém várias opções em tempo de execução da conexão FTP atual