socket_connect
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_connect — Baut eine Verbindung über einen Socket auf
Beschreibung
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
addressist entweder eine IPv4-Adresse in Punktnotation (z.B.127.0.0.1), fallssocketzurAF_INET-Familie gehört, oder eine gültige IPv6-Adresse (z.B::1), falls die IPv6-Unterstützung aktiviert ist undsocketzurAF_INET6-Familie gehört, oder der Pfadname eines Unix-Domain socket, falls der Socket zurAF_UNIX-Familie gehört. -
port -
Der Parameter
portwird nur benutzt und ist dann zwingend erforderlich, wenn eine Verbindung zu einemAF_INET- oder einemAF_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
falsesowie die FehlermeldungOperation now in progresszurü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
