diff --git a/reference/sockets/reference.xml b/reference/sockets/reference.xml index f6b0200025..838e69a236 100644 --- a/reference/sockets/reference.xml +++ b/reference/sockets/reference.xml @@ -1,5 +1,5 @@ - + Socket functions Sockets @@ -7,9 +7,9 @@ &warn.experimental; - The socket extension implements a low-level interface to the - socket communication functions, providing the possibility to act - as a socket server as well as a client. + The socket extension implements a low-level interface to the socket + communication functions based on the popular BSD sockets, providing the + possibility to act as a socket server as well as a client. The socket functions described here are part of an extension to @@ -29,11 +29,40 @@ descriptions to avoid confusion. - That said, those unfamiliar with socket programming can still find - a lot of useful material in the appropriate Unix man pages, and - there is a great deal of tutorial information on socket - programming in C on the web, much of which can be applied, with - slight modifications, to socket programming in PHP. + The socket extension was written to provide a useable interface to the + powerful BSD sockets. Care has been taken that the functions work equaly + well on Win32 and Unix implementations. Almost all of the sockets + functions may fail under certain conditions and therefore emit an + E_WARNING message describing the error. Sometimes this + doesn't happen to the desire of the developer. For example the function + socket_read may suddenly emit an + E_WARNING message because the connection broke + unexpectedly. It's common to suppress the warning with the + @-operator and catch the error code within the + application with the socket_last_error function. You + may call the socket_strerror function with this error + code to retrieve a string describing the error. See their description for + more information. + + + + The E_WARNING messages generated by the socket + extension are in english though the retrieved error message will appear + depending on the current locale (LC_MESSAGES): + + + + + + + That said, those unfamiliar with socket programming can still find a lot + of useful material in the appropriate Unix man pages, and there is a great + deal of tutorial information on socket programming in C on the web, much + of which can be applied, with slight modifications, to socket programming + in PHP. The UNIX Socket + FAQ might be a good start.