ftp_ssl_connect

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

ftp_ssl_connect — Öffnet eine sichere SSL-FTP-Verbindung

Beschreibung

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

ftp_ssl_connect() öffnet eine explizite SSL-FTP-Verbindung zu dem angegebenen host. Das impliziert, dass ftp_ssl_connect() gelingen wird, selbst wenn der Server nicht für SSL-FTP konfiguriert ist, oder sein Zertifikat ungültig ist. Erst wenn ftp_login() aufgerufen wird, sendet der Client das entsprechende AUTH-FTP-Kommando, so dass ftp_login() in den genannten Fällen fehlschlagen wird.

Hinweis: Warum diese Funktion eventuell nicht vorhanden ist

Vor PHP 7.0.0 war ftp_ssl_connect() nur verfügbar, wenn sowohl das FTP-Modul als auch OpenSSL-Unterstützung statisch in PHP eingebunden wurde. Daher war diese Funktion in den offiziellen PHP-Builds unter Windows nicht definiert. Um diese Funktion auch unter Windows verfügbar zu machen, musste PHP selbst kompiliert werden.

Hinweis:

ftp_ssl_connect() ist nicht dazu gedacht, mit sFTP benutzt zu werden. Um sFTP mit PHP zu benutzen, verwenden Sie bitte ssh2_sftp().

Parameter-Liste

host

Die Adresse des FTP-Servers. Die Adresse des FTP-Servers. Dieser Parameter sollte keinen abschließenden Schrägstrich und kein vorangestelltes ftp:// haben.

port

Gibt einen alternativen Port für die Verbindung an. Fehlt er oder wird er auf 0 gesetzt, wird der Standard-FTP-Port 21 benutzt.

timeout

Dieser Parameter bestimmt den Timeout für alle nachfolgenden Netzwerktätigkeiten. Falls er fehlt, wird er auf den Standardwert von 90 Sekunden gesetzt. Der Timeout kann jederzeit mittels ftp_set_option() gesetzt und mittels ftp_get_option() abgefragt werden.

Rückgabewerte

Gibt bei Erfolg einen SSL-FTP-Stream zurück oder FALSE, falls ein Fehler auftrat.

Changelog

Version Beschreibung
5.2.2 Diese Funktion gibt nun FALSE zurück, wenn sie keine SSL-Verbindung aufbauen kann. Vorher gab es einen Fallback auf eine Nicht-SSL-Verbindung.

Beispiele

Beispiel #1 ftp_ssl_connect()-Beispiel

<?php

// SSL-Verbindung aufbauen
$conn_id = ftp_ssl_connect($ftp_server);

// Login mit Benutzername und Passwort
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

if (!$login_result) {
    // PHP hat in diesem Fall bereits eine Nachricht der Stufe E_WARNING erzeugt
    die("Login nicht möglich");
}

echo ftp_pwd($conn_id); // /

// SSL-Verbindung schließen
ftp_close($conn_id);
?>

Siehe auch