ftp_ssl_connect

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

ftp_ssl_connect — 打開 SSL-FTP 連接

說明

ftp_ssl_connect(string $host, int $port = 21, int $timeout = 90): resource

ftp_ssl_connect() 顯式的打開一個到 host 的安全 FTP 連接（SSL-FTP）。 即使服務(wù)器未配置 SSL-FTP，或者服務(wù)器的證書無效，ftp_ssl_connect() 函數(shù)也會成功的建立到服務(wù)器的連接。直到調(diào)用 ftp_login() 函數(shù)的時候， 客戶端才會發(fā)送對應(yīng)的 AUTH FTP 命令，此時，如果服務(wù)器未配置 SSL-FTP 或者整數(shù)無效， ftp_login() 函數(shù)會失敗。

注意: 為何本函數(shù)有可能不存在？

只有 PHP 構(gòu)建時同時包含了 ftp 模塊 和 OpenSSL 模塊時， ftp_ssl_connect() 函數(shù)才可用。 也就是說，在 Windows 平臺上，官方發(fā)布的 PHP 構(gòu)建中本函數(shù)不可用。 如果需要在 Windows 平臺使用本函數(shù)，需要自行編譯 PHP。

注意:

ftp_ssl_connect() 不是用來連接 sFTP 服務(wù)的。 要在 PHP 中使用 sFTP，請參見 ssh2_sftp()。

參數(shù)

host

FTP 服務(wù)器地址。 此參數(shù)末尾不可以有斜線，開頭也不可以有 ftp://。

port

要連接的端口。如果省略此參數(shù)或設(shè)置為 0，將使用 FTP 默認(rèn)端口 21。

timeout

此參數(shù)設(shè)置所有后續(xù)網(wǎng)絡(luò)操作的超時時長。 如果省略，默認(rèn)值為 90 秒。 可以使用 ftp_set_option() 和 ftp_get_option() 函數(shù)隨時讀取或設(shè)置超時時長。

返回值

操作成功返回 SSL-FTP 流，操作失敗返回 false 。

更新日志

版本 說明
5.2.2 以前版本中，如果無法使用 SSL 連接，將會返回一個非 SSL 的連接， 在 5.2.2 版本中修改為返回 false

范例

示例 #1 ftp_ssl_connect() 函數(shù)例程

<?php

// 建立基礎(chǔ) SSL 連接
$conn_id = ftp_ssl_connect($ftp_server);

// 使用用戶名和密碼登錄
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

if (!$login_result) {
    // 在這種情況下，PHP 會發(fā)生 E_WARNING 級別的告警消息
    die("can't login");
}

echo ftp_pwd($conn_id); // /

// 關(guān)閉 ssl 連接
ftp_close($conn_id);
?>

參見