PHP Dokumentation: Function stream-socket-server
12. Januar 2010 von werner
stream_socket_server
(PHP 5)
stream_socket_server — Create an Internet or Unix domain server socket
Beschreibung
Creates a stream or datagram socket on the specified local_socket.
This function only creates a socket, to begin accepting connections use stream_socket_accept().
Parameter-Liste
- local_socket
The type of socket created is determined by the transport specified using standard URL formatting: transport://target.
For Internet Domain sockets (AF_INET) such as TCP and UDP, the target portion of the remote_socket parameter should consist of a hostname or IP address followed by a colon and a port number. For Unix domain sockets, the target portion should point to the socket file on the filesystem.
Depending on the environment, Unix domain sockets may not be available. A list of available transports can be retrieved using stream_get_transports(). See Liste der unterstützten Socket-Transporter for a list of bulitin php-dokumentation-transports.
- errno
If the optional errno and errstr arguments are present they will be set to indicate the actual system level error that occurred in the system-level socket(), bind(), and listen() calls. If the value returned in errno is 0 and the function returned FALSE, it is an indication that the error occurred before the bind() call. This is most likely due to a problem initializing the socket. Note that the errno and errstr arguments will always be passed by reference.
- errstr
See errno description.
- flags
A bitmask field which may be set to any combination of socket creation flags.
Hinweis: For UDP sockets, you must use STREAM_SERVER_BIND as the flags parameter.
- context
Rückgabewerte
Returns the created stream, or FALSE on error.
Beispiele
Beispiel #1 Using TCP server sockets
<?php
$socket = stream_socket_server("tcp://0.0.0.0:8000", $errno, $errstr);
if (!$socket) {
echo "$errstr ($errno)<br />\n";
} else {
while ($conn = stream_socket_accept($socket)) {
fwrite($conn, 'The local time is ' . date('n/j/Y g:i a') . "\n");
fclose($conn);
}
fclose($socket);
}
?>The example below shows how to act as a time server which can respond to time queries as shown in an example on stream_socket_client().
Hinweis: Most systems require root access to create a server socket on a port below 1024.
Beispiel #2 Using UDP server sockets
<?php
$socket = stream_socket_server("udp://127.0.0.1:1113", $errno, $errstr, STREAM_SERVER_BIND);
if (!$socket) {
die("$errstr ($errno)");
}do {
$pkt = stream_socket_recvfrom($socket, 1, 0, $peer);
echo "$peer\n";
stream_socket_sendto($socket, date("D M j H:i:s Y\r\n"), 0, $peer);
} while ($pkt !== false);?>Anmerkungen
Hinweis: Wenn Sie eine numerische IPv6-Adresseangeben, z.B. fe80::1, müssen Sie die IP in eckige Klammernschreiben, z.B. tcp://[fe80::1]:80.
Siehe auch
- stream_socket_client() – Open Internet or Unix domain socket connection
- stream_set_blocking() – Set blocking/non-blocking mode on a stream
- stream_set_timeout() – Set timeout period on a stream
- fgets() – Liest eine Zeile von der Position des Dateizeigers
- fgetss() – Liest eine Zeile von der Position des Dateizeigers und entfernt HTML Tags.
- fwrite() – Schreibt Binärdaten in eine Datei
- fclose() – Schließt einen offenen Dateizeiger
- feof() – Prüft, ob der Dateizeiger am Ende der Datei steht
- Curl extension