Signatur
Beschreibung
ftp_quit() ist ein Alias der Funktion ftp_close() und schließt die übergebene FTP-Verbindung ordnungsgemäß. Nach dem Aufruf ist das Verbindungs-Objekt ungültig und darf nicht mehr verwendet werden.
Die Funktion sendet den FTP-Befehl QUIT an den Server, woraufhin die TCP-Verbindung getrennt wird. Es empfiehlt sich, jede geöffnete FTP-Verbindung nach Abschluss aller Operationen explizit zu schließen, um Ressourcen freizugeben und den Server nicht unnötig zu belasten.
Da es sich um einen reinen Alias handelt, sind ftp_quit() und ftp_close() vollkommen gleichwertig. Für neuen Code wird die Verwendung von ftp_close() empfohlen, da Aliase in zukünftigen PHP-Versionen grundsätzlich entfernt werden könnten.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $ftp Pflicht | FTP\Connection | Eine aktive FTP-Verbindung, die zuvor mit ftp_connect() oder ftp_ssl_connect() geöffnet wurde. |
Rückgabewert
true zurück, wenn die Verbindung erfolgreich geschlossen wurde, andernfalls false.Beispiele
FTP-Verbindung öffnen und sauber schließen
<?php
$ftp = ftp_connect('ftp.example.com');
if ($ftp === false) {
die('Verbindung fehlgeschlagen.');
}
if (!ftp_login($ftp, 'benutzer', 'geheimesPasswort')) {
ftp_quit($ftp);
die('Login fehlgeschlagen.');
}
// FTP-Operationen durchführen
$dateien = ftp_nlist($ftp, '.');
if ($dateien !== false) {
foreach ($dateien as $datei) {
echo $datei . PHP_EOL;
}
}
// Verbindung sauber schließen
ftp_quit($ftp);
echo 'Verbindung getrennt.';
?>Vergleich mit ftp_close (Äquivalenz)
<?php
// ftp_quit() und ftp_close() sind vollständig gleichwertig.
// Beide Varianten schließen die Verbindung identisch:
$ftp = ftp_connect('ftp.example.com');
ftp_login($ftp, 'benutzer', 'geheimesPasswort');
// Variante 1 (Alias):
ftp_quit($ftp);
// Variante 2 (bevorzugt):
// ftp_close($ftp);
echo 'Verbindung getrennt.';
?>// Wichtig · Fallstricke
Alias-Warnung: ftp_quit() ist ein Alias von ftp_close(). PHP-Aliase können in zukünftigen Hauptversionen ohne Vorwarnung entfernt werden. Es wird daher empfohlen, in neuem Code stets ftp_close() zu verwenden.
Ab PHP 8.1 ist der Typ des Parameters FTP\Connection (ein dediziertes Objekt) statt der früher verwendeten Ressource (resource). Bestehender Code, der eine Ressource übergab, muss ggf. angepasst werden.