strerror

(4.0.2 - 4.0.6 only)

strerror -- Return a string describing a socket error

Description

string strerror (int errno)

Warning

This function is EXPERIMENTAL. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this function at your own risk.

strerror() takes as its errno parameter the return value of one of the socket functions, and returns the corresponding explanatory text. This makes it a bit more pleasant to figure out why something didn't work; for instance, instead of having to track down a system include file to find out what '-111' means, you just pass it to strerror(), and it tells you what happened.

Example 1. strerror() example


<?php
if (($socket = socket (AF_INET, SOCK_STREAM, 0)) < 0) {
   echo "socket() failed: reason: " . strerror ($socket) . "\n";
} 

if (($ret = bind ($socket, '127.0.0.1', 80)) < 0) {
   echo "bind() failed: reason: " . strerror ($ret) . "\n";
}
?>
      

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

        bind() failed: reason: Permission denied
       

See also accept_connect(), bind(), connect(), listen(), socket(), and socket_get_status().