PHP Handbuch
Zurück |  | Weiter

# socket_create_pair

(PHP 4 >= 4.1.0, PHP 5)

socket_create_pair -- Erzeugt ein paar von unverwechselbaren Sockets und speichert sie in einem Array.

## Beschreibung

bool socket_create_pair ( int domain, int type, int protocol, array &fd )

socket_create_pair() erzeugt zwei nicht unterscheidbare verbundene Sockets und speichert sie im Array fd. Diese Funktion wird allgemein bei der Inter-Prozess-Kommunikation (IPC) verwendet.

Der Parameter domain bestimmt die Protokollfamilie, die von den Sockets benutzt werden.

Tabelle 1. Mögliche Adressen/Protokollfamilien

Domain | Beschreibung
--- | ---
AF_INET | IPv4 basiertes Internetprotokoll. TCP und UDP sind gebräuchliche Protokolle dieser Familie (die nur von Windows unterstützt wird).
AF_INET6 | IPv6 basierte Internetprotokolle. TCP und UDP sind gebräuchliche Protokolle dieser Familie. Die Unterstützung für IPv6 wurde mit PHP 5.0.0 eingeführt und wird nur unter windows unterstützt.
AF_UNIX | Protokollfamilie für die lokale Kommunikation. Hohe Effizienz bei wenig Overhead machen diese Familie zur besten Wahl für die Inter-Prozess-Kommunikation.

Der Parameter type gibt den Kommunikationstyp an, den der Socket verwenden soll.

Tabelle 2. Die möglichen Socket-Typen sind:

Type | Beschreibung
--- | ---
SOCK_STREAM | Stellt zuverlässige, sequentielle verbindungsorientierte Streams im Vollduplexmodus zur Verfügung. Ein externer Mechanismus zur Datenübertragung kann unterstützt werden. Das TCP-Protokoll beruht auf diesem Socket.Typ.
SOCK_DGRAM | Unterstützt Datagramme (verbindunglos, Nachrichten vorgegebener Maximallänge, deren Übertragung nicht zuverlässig ist). Das UDP-Protikoll beruht auf diesem Socket-Typ.
SOCK_SEQPACKET | Stellt eine zuverlässige, sequentielle. bidirektionale verbindungsorientierte Übertragungsweg für Datagramme vorgegebener Maximallänge zur Verfügung. Ein Empfänger muss bei jeder Leseanforderung das gesamte Datenpaket lesen.
SOCK_RAW | Stellt einen Zugang mit einem nicht bestimmten Netzwerkprotokoll zur Verfügung. Dieser spezielle Socket-Typ kann dazu benutzt werden, um manuell ein Protokoll eines beliebigen Typs zu erstellen. Solche Sockets werden üblicherweise benutzt, um ICMP Requests zu senden (wie etwa ping oder traceroute usw.).
SOCK_RDM | Stellt eine zuverlässige Schicht für Datagramme zur Verfügung, in der die Reihenfolge der Datagramme nicht garantiert wird. Dies ist in Ihrem Betriebssytem höchstwahrscheinlich nicht implementiert.

Der Parameter protocol setzt das spezifische Protokoll innerhalb der angegebenen domain, das vom zurückgegebenen Socket für die Kommunikation benutzt wird. Der passende Wert kann ermittelt werden, indem der Name an die Funktion getprotobyname()übergeben wird. Wenn TCP oder UDP gewünscht werden, können auch die entsprechenden Konstanten `SOL_TCP` oder `SOL_UDP` benutzt werden.

Tabelle 3. Gebräuchliche Protokolle

Name | Beschreibung
--- | ---
icmp | Das Internet Control Message Protocol wird hauptsächlich von Gateways und Hosts benutzt, um Datagramm-Fehler zu melden. Das Kommando "ping" (das in den meisten modernen Betriebssystemen enthalten ist) ist ein Beispiel für eine Anwendung von ICMP.
udp | Das User Datagram Protocol ist ein verbindungsloses, unzuverlässiges Protokoll, mit dem Datensätze fester Länge versendet werden können. Aufgrund dieser geringen Anforderungen braucht UDP nur einen minimalen Protokoll-Overhead.
tcp | Das Transmission Control Protocol ist ein zuverlässiges, verbindungsorientiertes, Stream-orientiertes Protokoll für den Vollduplex-Betrieb. Bei TCP ist garantiert, dass alle Datenpakete in derselben Reihenfolge empfangen werden, in der sie gesendet wurden. Falls während der Übertragung ein Datenpaket verlorengeht, wird es von TCP erneut versendet, und zwar solange, bis der Empfängerhost den Eingang dieses Paktes zurückmeldet. Aus Gründen der Zuverlässigkeit und Leistung ist TCP so implementiert, dass es eigenständig die oktalen Grenzen der darunterliegenden Datagramm- Kommunikationschicht anpassen kann. Aus diesem Grund müssen TCP Anwendungen in der Lage sein, auch Teilübertragungen empfangen zu können.

Beispiel 1. socket_create_pair() Beispiel
`<?php $sockets = array(); /* ein Socket-Paar erzeugen */ if (!socket_create_pair(AF_UNIX, SOCK_STREAM, 0, $sockets)) { echo socket_strerror(socket_last_error()); } /* Daten senden und empfangen */ if (!socket_write($sockets[0], "ABCdef123\n", strlen("ABCdef123\n"))) { echo socket_strerror(socket_last_error()); } if (!$data = socket_read($sockets[1], strlen("ABCdef123\n"), PHP_BINARY_READ)) { echo socket_strerror(socket_last_error()); } var_dump($data); /* Sockets schliessen */ socket_close($sockets[0]); socket_close($sockets[1]); ?>`

Beispiel 2. socket_create_pair() IPC Beispiel
`<?php $ary = array(); $strone = 'Nachricht vom Elternprozess.'; $strtwo = 'Nachricht vom Kindprozess.'; if (!socket_create_pair(AF_UNIX, SOCK_STREAM, 0, $ary)) { echo socket_strerror(socket_last_error()); } $pid = pcntl_fork(); if ($pid == -1) { echo 'Konnte keinen Kindprozess erzeugen.'; } elseif ($pid) { /* Elternprozess */ socket_close($ary[0]); if (!socket_write($ary[1], $strone, strlen($strone))) { echo socket_strerror(socket_last_error()); } if (socket_read($ary[1], strlen($strtwo), PHP_BINARY_READ) == $strtwo) { echo "Empfangen: $strtwo\n"; } socket_close($ary[1]); } else { /* Kindprozess */ socket_close($ary[1]); if (!socket_write($ary[0], $strtwo, strlen($strtwo))) { echo socket_strerror(socket_last_error()); } if (socket_read($ary[0], strlen($strone), PHP_BINARY_READ) == $strone) { echo "Empfangen: $strone\n"; } socket_close($ary[0]); } ?>`

Zurück | Zum Anfang | Weiter
socket_create_listen | Nach oben | socket_create