(PHP 4 >= 4.1.0)
socket_strerror -- Return a string describing a socket error
Description
string socket_strerror (int errno)
| Warning |
|
This function is EXPERIMENTAL. The behaviour of this function, the name of this
function, and anything else documented about this function may change in a future release of PHP
without notice. Be warned and use this function at your own risk.
|
socket_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
socket_strerror(), and it tells you what happened.
|
Example 1. socket_strerror() example
<?php
if (($socket = socket_create (AF_INET, SOCK_STREAM, 0)) < 0) {
echo "socket_create() failed: reason: " . socket_strerror ($socket) . "\n";
}
if (($ret = socket_bind ($socket, '127.0.0.1', 80)) < 0) {
echo "socket_bind() failed: reason: " . socket_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 socket_accept(), socket_bind(),
socket_connect(), socket_listen(), socket_create(), and socket_get_status().
|
