Edit Report a Bug

    stream_socket_shutdown

    (PHP 5 >= 5.2.1, PHP 7, PHP 8)

    stream_socket_shutdown — Закрыть полнодуплексное соединение

    Описание

    stream_socket_shutdown(resource $stream, int $mode): bool

    Закрывает (частично или нет) полнодуплексное соединение.

    Замечание:

    Ассоциированные буферы, или буферы, могут быть закрыты, а могут и нет.

    Список параметров

    stream

    Открытый поток (например, открытый при помощи функции stream_socket_client())

    mode

    Одна из следующих констант: STREAM_SHUT_RD (отключает последующее получение данных), STREAM_SHUT_WR (отключает последующую передачу данных) или STREAM_SHUT_RDWR (отключает последующие получение и передачу данных).

    Возвращаемые значения

    Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

    Примеры

    Пример #1 Пример использования stream_socket_shutdown()

    <?php

    $server     = stream_socket_server('tcp://127.0.0.1:1337');
    $client = stream_socket_client('tcp://127.0.0.1:1337');

    var_dump(fputs($client, "привет"));

    stream_socket_shutdown($client, STREAM_SHUT_WR);
    var_dump(fputs($client, "привет")); // не работает сейчас

    ?>

    Вывод приведённого примера будет похож на: 

    int(5)

Notice: fputs(): send of 6 bytes failed with errno=32 Broken pipe in test.php on line 9
int(0)

    Смотрите также

    • fclose() - Закрывает открытый дескриптор файла

    add a note add a note

    User Contributed Notes 3 notes

    up
    3
    Daniel J
    3 years ago
    Be wary of using stream_socket_shutdown with a TLS socket. The socket is closed without sending the "close_notify" message required by TLS protocol.

    To correctly close a TLS socket, use fclose() instead, which internally calls OpenSSL's SSL_shutdown() function.
    up
    1
    jgotti
    12 years ago
    Just a note to say that if you encounter problem closing some sockets using fclose in a multi client server, you should really  give this one a try.

    Spent a full day trying to resolve this issue using stream_socket_shutdown($clientStream,STREAM_SHUT_RDWR);
    finally do the trick.
    up
    1
    Anonymous
    3 years ago
    As Daniel J has pointed out, stream_socket_shutdown doesn't send the TLS close_notify message. In some instances, it's a preferred function over fclose (to trigger stream_select, for example).

    To use this function correctly with TLS, use stream_socket_enable_crypto($fp, false); before shutting down the socket.
    add a note add a note
    To Top