Setzt diverse FTP-Laufzeitoptionen

Beschreibung

function ftp_set_option(FTP\Connection $ftp, int $option, int|bool $value): true

Diese Funktion kontrolliert diverse FTP-Laufzeitoptionen für die angegebene FTP-Verbindung.

Parameter-Liste

ftp

option

Zur Zeit werden folgende Optionen unterstützt:

**Unterstützte FTP-Laufzeitoptionen**
`FTP_TIMEOUT_SEC`	Ändert den Timeout in Sekunden für alle folgenden Netzwerkoperationen. `value` muss eine ganze Zahl sein, die größer als 0 ist. Der Standardwert des Timeouts ist 90 Sekunden.
`FTP_AUTOSEEK`	Falls aktiviert, werden GET- oder PUT-Anfragen mit einem `resumepos`- oder `startpos`-Parameter innerhalb der Datei zuerst die angegebene Position suchen. Dies ist standardmäßig aktiviert.
`FTP_USEPASVADDRESS`	Falls deaktiviert, ignoriert PHP die IP-Adresse, die vom FTP-Server als Antwort auf das PASV-Kommando zurückgegeben wurde, und verwendet stattdessen die IP-Adresse, die im ftp_connect()-Aufruf bereitgestellt wurde. `value` muss ein Boolean sein.

value

Dieser Parameter hängt davon ab, welche option für die Änderung ausgewählt wurde.

Rückgabewerte

Gibt immer true zurück.

Fehler/Exceptions

Eine ValueError-Ausnahme wird ausgelöst, wenn die option nicht unterstützt wird. Eine TypeError-Ausnahme wird ausgelöst, wenn der übergebene value nicht dem erwarteten Typ für die angegebene option entspricht.

Changelog

Version	Beschreibung
8.5.0	Der Rückgabetyp ist nun `true`; vorher war er bool.
8.1.0	Der Parameter `ftp` erwartet nun eine FTP\Connection-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 ftp_set_option()-Beispiel

<?php
// Setze den Netzwerk-Timeout auf 10 Sekunden
ftp_set_option($ftp, FTP_TIMEOUT_SEC, 10);
?>

Siehe auch

ftp_get_option() - Ruft diverse Laufzeitoptionen der angegebenen FTP-Verbindung ab