socket_strerror

Return a string describing a socket error

&reftitle.description; `string` `socket_strerror` `int` `error_code`

`socket_strerror` takes as its `error_code` parameter a socket error code as returned by `socket_last_error` and returns the corresponding explanatory text.

Although the error messages generated by the socket extension are in English, the system messages retrieved with this function will appear depending on the current locale (`LC_MESSAGES`).

&reftitle.parameters;

`error_code`

- A valid socket error number, likely produced by `socket_last_error`.

&reftitle.returnvalues;

Returns the error message associated with the `error_code` parameter.

&reftitle.examples;

### `socket_strerror` example

    <?php
    if (false == ($socket = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP))) {
       echo "socket_create() failed: reason: " . socket_strerror(socket_last_error()) . "\n";
    }

    if (false == (@socket_bind($socket, '127.0.0.1', 80))) {
       echo "socket_bind() failed: reason: " . socket_strerror(socket_last_error($socket)) . "\n";
    }
    ?>

The expected output from the above example (assuming the script is not run with root privileges):

    socket_bind() failed: reason: Permission denied

&reftitle.seealso;

- `socket_accept`
- `socket_bind`
- `socket_connect`
- `socket_listen`
- `socket_create`