PHP Manual
Socket-Funktionen
Baut eine Verbindung über einen Socket auf

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

socket_bind() - Verknüpft einen Socket mit einem Namen
socket_listen() - Hört einen Socket nach Verbindungsanforderungen ab
socket_create() - Erzeugt einen Socket (Endpunkt für die Kommunikation)
socket_last_error() - Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist
socket_strerror() - Gibt einen String zurück, der einen Socket-Fehler beschreibt