socket_connect

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

socket_connect — Baut eine Verbindung über einen Socket auf

Beschreibung

socket_connect(Socket $socket, string $address, ?int $port = null): bool

Baut über die Socket-Instanz socket, die mittels socket_create() erzeugt worden sein muss, eine Verbindung zu address auf.

Parameter-Liste

socket

Eine Socket-Instanz, die mit socket_create() erzeugt wurde.

address

Der Parameter address ist entweder eine IPv4-Adresse in Punktnotation (z. B. 127.0.0.1), falls socket zur AF_INET-Familie gehört, oder eine gültige IPv6-Adresse (z. B. ::1), falls die IPv6-Unterstützung aktiviert ist und socket zur AF_INET6-Familie gehört, oder der Pfadname eines Unix-Domain socket, falls der Socket zur AF_UNIX-Familie gehört.

port

Der Parameter port wird nur benutzt und ist dann zwingend erforderlich, wenn eine Verbindung zu einem AF_INET- oder einem AF_INET6-Socket aufgebaut wird. Er gibt an, zu welchem Port des entfernten Hosts eine Verbindung hergestellt werden soll.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben. Der Fehlercode kann mit der Funktion socket_last_error() ermittelt werden. Dieser Fehlercode kann an die Funktion socket_strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Hinweis:

Falls der Socket nicht blockiert ist, gibt diese Funktion false sowie die Fehlermeldung Operation now in progress zurück.

Changelog

Version Beschreibung
8.0.0 socket ist nun eine Socket-Instanz; vorher war es eine resource.
8.0.0 port ist nun ein Nullable-Typ.

Siehe auch