array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.socket-atmark.php', 1 => 'socket_atmark', 2 => 'Détermine si le socket est à la marque hors bande', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Fonctions sur les sockets', ), 'prev' => array ( 0 => 'function.socket-addrinfo-lookup.php', 1 => 'socket_addrinfo_lookup', ), 'next' => array ( 0 => 'function.socket-bind.php', 1 => 'socket_bind', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sockets/functions/socket-atmark.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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