socket_atmark

(PHP 8 >= 8.3.0, PHP 8)

socket_atmark — Détermine si le socket est à la marque hors bande

Description

socket_atmark(Socket $socket): bool

Détermine si socket est à la marque hors bande.

Liste de paramètres

socket

Une instance de Socket créée avec socket_create().

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Utilisation de socket_atmark() pour vérifier si le socket est prêt à lire des données hors bande.

<?php
$socketServer = socket_create( AF_INET, SOCK_STREAM, SOL_TCP );
socket_set_option( $socketServer, SOL_SOCKET, SO_REUSEADDR, 1 );
socket_bind( $socketServer, '127.0.0.1' );
socket_listen( $socketServer );

$socketClient = socket_create( AF_INET, SOCK_STREAM, SOL_TCP );
socket_getsockname( $socketServer, $stAddr, $uPort );
socket_connect( $socketClient, $stAddr, $uPort );

$socket = socket_accept( $socketServer );
socket_shutdown( $socket, 1 );

$st = 'Ceci est une donnée normale.';
socket_send( $socketClient, $st, strlen( $st ), 0 );
$st = '!'; # TCP n'autorise qu'un seul octet de donnée urgente.
socket_send( $socketClient, $st, strlen( $st ), MSG_OOB );
$st = 'Pas si urgent.';
socket_send( $socketClient, $st, strlen( $st ), 0 );
socket_shutdown( $socketClient );

do {
if ( socket_atmark( $socket ) ) {
$rc = socket_recv( $socket, $st, 65536, MSG_OOB );
echo "Donnée urgente reçue : ({$rc}) {$st}\n";
} else {
$rc = socket_recv( $socket, $st, 1024, 0 );
echo "Donnée normale reçue : ({$rc}) {$st}\n";
}
} while ( $rc > 0 );
socket_close( $socketServer );
socket_close( $socketClient );
socket_close( $socket );
?>

L'exemple ci-dessus va afficher :

Donnée normale reçue : (28) Ceci est une donnée normale.
Donnée urgente reçue : (1) !
Donnée normale reçue : (14) Pas si urgent.
Donnée normale reçue : (0)

Voir aussi