ftp_ssl_connect

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

ftp_ssl_connect — Abre uma conexão SSL-FTP segura

Descrição

ftp_ssl_connect(string $hostname, int $port = 21, int $timeout = 90): FTP\Connection|false

ftp_ssl_connect() abre uma conexão SSL-FTP explícita com o servidor informado em hostname. Isso implica que ftp_ssl_connect() terá sucesso mesmo se o servidor não estiver configurado para SSL-FTP. Somente quando a função ftp_login() for chamada, o cliente enviará o comando AUTH FTP apropriado, portanto ftp_login() falhará. A conexão estabelecida por ftp_ssl_connect() não fará verificação de certificado de par.

Note: Por que esta função pode não existir

Antes do PHP 7.0.0, ftp_ssl_connect() só estava disponível se tanto o módulo FTP quanto o suporte OpenSSL tivessem sido construídos estaticamente no PHP. Isso significa que no Windows esta função estava indefinida nas compilações oficiais do PHP. Para ter esta função disponível no Windows, foi necessário compilar binários PHP próprios.

Note:

ftp_ssl_connect() não se destina ao uso com sFTP. Para usar sFTP com PHP, consulte ssh2_sftp().

Parâmetros

hostname

O endereço do servidor FTP. Este parâmetro não deve ter barras finais e não deve ser prefixado com ftp://.

port

Este parâmetro especifica uma porta alternativa para conexão. Se for omitido ou definido como zero, a porta FTP padrão, 21, será usada.

timeout

Este parâmetro especifica o tempo limite para todas as operações de rede subsequentes. Se omitido, o valor padrão será 90 segundos. O tempo limite pode ser alterado e consultado a qualquer momento com ftp_set_option() e ftp_get_option().

Valor Retornado

Retorna uma instância de FTP\Connection em caso de sucesso, ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 Retorna uma instância de FTP\Connection agora; anteriormente, um resource era retornado.

Exemplos

Example #1 Exemplo de ftp_ssl_connect()

<?php

// configura conexão SSL básica
$ftp = ftp_ssl_connect($ftp_server);

// registra com usuário e senha
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

if (!$login_result) {
    // O PHP já teria gerado uma mensagem de nível E_WARNING neste caso
    die("não foi possível registrar");
}

echo ftp_pwd($ftp);

// fecha a conexão SSL
ftp_close($ftp);
?>

Veja Também