php8.5
Home/ Manual/ sockets / functions/ socket_strerror

socket_strerror

PHP function Edit on GitHub ✎

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

Return a string describing a socket error

Description

socket_strerror(int $error_code): string

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

Note

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).

Parameters

error_code

A valid socket error number, likely produced by socket_last_error().

Return Values

Returns the error message associated with the error_code parameter.

Examples

socket_strerror() example

php
<?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):

output
socket_bind() failed: reason: Permission denied

See Also

Source: reference/sockets/functions/socket-strerror.xml · from the official PHP manual (php/doc-en)