PHP Conference Nagoya 2025

    socket_last_error

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

    socket_last_error — Retorna o último erro no soquete

    Descrição

    socket_last_error(?Socket $socket = null): int

    Se uma instância de Socket for passada para esta função, o último erro que ocorreu neste soquete específico será retornado. Se socket for null, o código de erro da última função de soquete com falha será retornado. O último é particularmente útil para funções como socket_create() que não retorna um soquete em caso de falha e socket_select() que pode falhar por motivos não diretamente ligados a um soquete específico. O código de erro é adequado para ser usado em socket_strerror() que retorna uma string descrevendo o código de erro fornecido.

    Se nenhum erro ocorreu ou o erro foi eliminado com socket_clear_error(), a função retorna 0.

    Parâmetros

    socket

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

    Valor Retornado

    Esta função retorna um código de erro de soquete.

    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 socket agora pode ser nulo.

    Exemplos

    Exemplo #1 Exemplo de socket_last_error()

    <?php
    $socket     = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

    if (    $socket === false) {
    $errorcode = socket_last_error();
    $errormsg = socket_strerror($errorcode);

    die(    "Não foi possível criar o soquete: [$errorcode] $errormsg");
    }
    ?>

    Notas

    Nota:

    socket_last_error() não limpa o código de erro, socket_clear_error() deve ser usado para este fim.

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 2 notes

    up
    13
    ca at php dot spamtrak dot org
    14 years ago
    This is a bit long, but personally I prefer to use the standard C defines in my code.

    <?php

    define    ('ENOTSOCK', 88); /* Socket operation on non-socket */
    define('EDESTADDRREQ', 89); /* Destination address required */
    define('EMSGSIZE', 90); /* Message too long */
    define('EPROTOTYPE', 91); /* Protocol wrong type for socket */
    define('ENOPROTOOPT', 92); /* Protocol not available */
    define('EPROTONOSUPPORT', 93); /* Protocol not supported */
    define('ESOCKTNOSUPPORT', 94); /* Socket type not supported */
    define('EOPNOTSUPP', 95); /* Operation not supported on transport endpoint */
    define('EPFNOSUPPORT', 96); /* Protocol family not supported */
    define('EAFNOSUPPORT', 97); /* Address family not supported by protocol */
    define('EADDRINUSE', 98); /* Address already in use */
    define('EADDRNOTAVAIL', 99); /* Cannot assign requested address */
    define('ENETDOWN', 100); /* Network is down */
    define('ENETUNREACH', 101); /* Network is unreachable */
    define('ENETRESET', 102); /* Network dropped connection because of reset */
    define('ECONNABORTED', 103); /* Software caused connection abort */
    define('ECONNRESET', 104); /* Connection reset by peer */
    define('ENOBUFS', 105); /* No buffer space available */
    define('EISCONN', 106); /* Transport endpoint is already connected */
    define('ENOTCONN', 107); /* Transport endpoint is not connected */
    define('ESHUTDOWN', 108); /* Cannot send after transport endpoint shutdown */
    define('ETOOMANYREFS', 109); /* Too many references: cannot splice */
    define('ETIMEDOUT', 110); /* Connection timed out */
    define('ECONNREFUSED', 111); /* Connection refused */
    define('EHOSTDOWN', 112); /* Host is down */
    define('EHOSTUNREACH', 113); /* No route to host */
    define('EALREADY', 114); /* Operation already in progress */
    define('EINPROGRESS', 115); /* Operation now in progress */
    define('EREMOTEIO', 121); /* Remote I/O error */
    define('ECANCELED', 125); /* Operation Canceled */
    ?>
    up
    1
    divinity76 at gmail dot com
    5 years ago
    note that socket_last_error() cache the last error from the last socket syscall, it does not actually query the OS for the last error on the socket, so if an async socket have an error after the last async operation started successfully, socket_last_error() doesn't know about it, but socket_get_option($sock, SOL_SOCKET, SO_ERROR) actually query the OS, or so it seems... observed on PHP 7.1.16 on Cygwin on win7 x64 SP1 with non-blocking sockets, socket_last_error() never caught on to the fact that the current error had changed from EINPROGRESS (non-blocking connect) to 0 (connection successful)
    ＋adicione uma nota
    To Top