array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.socket-atmark.php', 1 => 'socket_atmark', 2 => 'Determina se o soquete está na marca fora-de-banda', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções de Socket', ), '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' => 'pt_BR', '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 — Determina se o soquete está na marca fora-de-banda

Descrição

socket_atmark(Socket $socket): bool

Determina se o soquete informado em socket está na marca fora-de-banda.

Parâmetros

socket

Uma instância de Socket criada com socket_create().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Usando socket_atmark() para verificar se o soquete está pronto para ler dados fora-de-banda

<?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 = 'Estes são dados normais.';
socket_send( $socketClient, $st, strlen( $st ), 0 );
$st = '!'; # TCP permite somente um byte de dados urgentes.
socket_send( $socketClient, $st, strlen( $st ), MSG_OOB );
$st = 'Não tão urgente.';
socket_send( $socketClient, $st, strlen( $st ), 0 );
socket_shutdown( $socketClient );

do {
if ( socket_atmark( $socket ) ) {
$rc = socket_recv( $socket, $st, 65536, MSG_OOB );
echo "Dados urgentes recebidos: ({$rc}) {$st}\n";
} else {
$rc = socket_recv( $socket, $st, 1024, 0 );
echo "Dados normais recebidos: ({$rc}) {$st}\n";
}
} while ( $rc > 0 );
socket_close( $socketServer );
socket_close( $socketClient );
socket_close( $socket );
?>

O exemplo acima produzirá:

Received normal data: (20) Estes são dados normais.
Received urgent data: (1) !
Received normal data: (14) Não tão urgente.
Received normal data: (0)

Veja Também