PHP 8.5.0 Alpha 1 available for testing

stream_socket_shutdown

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

stream_socket_shutdownDetiene una conexión full-duplex

Descripción

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

Detiene (parcialmente o no) una conexión full-duplex.

Nota:

El o los buffers asociados pueden o no ser vaciados.

Parámetros

stream

Un flujo abierto (abierto con la función stream_socket_client(), por ejemplo)

mode

Una de las constantes siguientes: STREAM_SHUT_RD (desactiva las recepciones futuras), STREAM_SHUT_WR (desactiva las transmisiones futuras) o STREAM_SHUT_RDWR (desactiva las recepciones o las transmisiones futuras).

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con 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, "Hola"));

stream_socket_shutdown($client, STREAM_SHUT_WR);
var_dump(fputs($client, "Hola")); // actualmente no funciona

?>

El resultado del ejemplo sería algo similar a:

int(5)

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

Ver también

add a note

User Contributed Notes 3 notes

up
5
Daniel J
4 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
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.
up
0
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.
To Top