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

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

    Siehe auch

    To Top