socket_sendto

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_sendto — Envia uma mensagem para um soquete, esteja ele conectado ou não

Descrição

socket_sendto(
    Socket $socket,
    string $data,
    int $length,
    int $flags,
    string $address,
    ?int $port = null
): int|false

A função socket_sendto() envia o número de bytes especificado em length a partir dos dados informados em data através do soquete socket para a porta definida em port no endereço address.

Parâmetros

socket

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

data

Os dados serão enviados a partir do buffer definido em data.

length

O número de bytes definido em length a partir dos dados em data será enviado.

flags

O valor de flags pode ser qualquer combinação das opções a seguir, combinadas com o operador binário OR (|).

Valores possíveis para flags
MSG_OOB Envia dados OOB (fora-de-banda).
MSG_EOR Indica uma marca de registro. Os dados enviados completam o registro.
MSG_EOF Fecha o lado do remetente do soquete e inclui uma notificação apropriada no final dos dados enviados. Os dados enviados completam a transação.
MSG_DONTROUTE Ignora o roteamento, usa interface direta.
address

Endereço IP do servidor remoto.

port

port é o número da porta remota para a qual os dados serão enviados.

Valor Retornado

socket_sendto() retorna o número de bytes enviados para o servidor remoto ou false se ocorrer um erro.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro socket agora espera uma instância de Socket; anteriormente, um resource era esperado.
8.0.0 port agora pode ser nulo.

Exemplos

Example #1 Exemplo de socket_sendto()

<?php
    $sock = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);

    $msg = "Ping !";
    $len = strlen($msg);

    socket_sendto($sock, $msg, $len, 0, '127.0.0.1', 1223);
    socket_close($sock);
?>

Veja Também