socket_read

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

    socket_read — Liest höchstens die angegebene Anzahl Bytes von einem Socket

    Beschreibung

    socket_read(Socket$socket, int$length, int$mode = PHP_BINARY_READ): string|false

    Die Funktion socket_read() liest von der Socket-Instanz socket, die entweder mit socket_create() oder mit socket_accept() erzeugt wurde.

    Parameter-Liste

    socket

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

    length

    Die Anzahl Bytes, die höchstens gelesen werden, wird in dem Parameter length angegeben. Anderenfalls können Sie mit \r, \n, oder \0 den Lesevorgang beenden (dies ist abhängig von dem Parameter mode, siehe weiter unten).

    mode

    Der optionale Parameter mode ist eine vordefinierte Konstante:

    • PHP_BINARY_READ (Standardwert) - benutzt die Systemfunktion recv(). Das ist sicher zum Lesen von Binärdaten.
    • PHP_NORMAL_READ - Lesevorgänge werden bei \n oder \r beendet.

    Rückgabewerte

    socket_read() gibt bei Erfolg die Daten als String zurück oder false, falls ein Fehler aufgetreten ist (einschließlich, wenn der entfernte Host die Verbindung abgebrochen hat). Der Fehlercode kann mit socket_last_error() abgefragt werden. Dieser Fehlercode kann an die Funktion socket_strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

    Hinweis:

    socket_read() gibt einen leeren String ("") zurück, wenn es keine Daten mehr zu lesen gibt.

    Changelog

    VersionBeschreibung
    8.0.0socket ist nun eine Socket-Instanz; vorher war es eine resource.

    Siehe auch

    To Top