(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ftp_ssl_connect — Abre uma conexão SSL-FTP segura
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 ou se seu certificado for inválido. Somente quando
a função ftp_login() for chamada, o cliente enviará o
comando AUTH FTP apropriado, então ftp_login() falhará nos
casos mencionados.
Nota: 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.
Nota:
ftp_ssl_connect() não se destina ao uso com sFTP. Para usar sFTP com PHP, consulte ssh2_sftp().
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().
Retorna uma instância de FTP\Connection em caso de sucesso, ou false
em caso de falha.
Versão | Descrição |
---|---|
8.1.0 | Retorna uma instância de FTP\Connection agora; anteriormente, um resource era retornado. |
Exemplo #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);
?>