# 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open