(PHP 5 >= 5.2.1, PHP 7, PHP 8)
stream_socket_shutdown — Arrête une connexion full-duplex
Arrête (partiellement ou non) une connexion full-duplex.
Note:
Le ou les buffers associés peuvent ou non être vidés.
streamUn flux ouvert (ouvert avec la fonction stream_socket_client(), par exemple)
mode
Une des constantes suivantes : STREAM_SHUT_RD
(désactive les réceptions futures), STREAM_SHUT_WR
(désactive les transmissions futures) ou
STREAM_SHUT_RDWR (désactive les réceptions ou les
transmissions futures).
Exemple #1 Exemple avec 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, "Bonjour"));
stream_socket_shutdown($client, STREAM_SHUT_WR);
var_dump(fputs($client, "Bonjour")); // ne fonctionne actuellement pas
?>Résultat de l'exemple ci-dessus est similaire à :
int(5) Notice: fputs(): send of 5 bytes failed with errno=32 Broken pipe in test.php on line 9 int(0)
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.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.