socket_create
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_create — Erzeugt einen Socket (Endpunkt für die Kommunikation)
Beschreibung
Erzeugt eine Socket-Instanz (auch als Kommunikations-Endpunkt bezeichnet) und gibt sie zurück. Eine typische Netzwerkverbindung besteht aus zwei Sockets, von denen der eine die Rolle des Clients und der andere die Rolle des Servers übernimmt.
Parameter-Liste
-
domain -
Der
domain-Parameter legt die Protokollfamilie fest, die für die Kommunikation vom Socket benutzt wird.Folgende Adressen/Protokollfamilien sind verfügbar: Domain Beschreibung AF_INETIPv4-basierte Internet-Protokolle. TCP und UDP sind allgemein gebräuchliche Protokolle dieser Familie. AF_INET6IPv6-basierte Internet-Protokolle. TCP und UDP sind allgemein gebräuchliche Protokolle dieser Familie. AF_UNIXProtokollfamilie für die lokale Kommunikation. Hohe Effizienz und ein geringer Overhead machen sie zur ersten Wahl für die IPC (Inter-Process Communication). -
type -
Der Parameter
typebestimmt den Kommunikationstyp, den der Socket verwenden soll.Mögliche Socket-Typen Typ Beschreibung SOCK_STREAMStellt zuverlässige, sequentielle verbindungsorientierte Byte-Streams im Vollduplexmodus zur Verfügung. Auch bandexterne Mechanismen zur Datenübertragung können unterstützt werden. Das TCP-Protokoll beruht auf diesem Socket-Typ. SOCK_DGRAMUnterstützt Datagramme (verbindunglos, Nachrichten vorgegebener Maximallänge, deren Übertragung nicht zuverlässig ist). Das UDP-Protokoll beruht auf diesem Socket-Typ. SOCK_SEQPACKETStellt einen zuverlässigen, sequentiellen, bidirektionalen, verbindungsorientierten Übertragungsweg für Datagramme vorgegebener Maximallänge zur Verfügung. Ein Empfänger muss bei jeder Leseanforderung das gesamte Datenpaket lesen. SOCK_RAWStellt 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 bei ping). SOCK_RDMStellt eine zuverlässige Schicht für Datagramme zur Verfügung, in der die Reihenfolge der Datagramme nicht garantiert wird. Dies ist in den meisten Betriebssytemen nicht implementiert. -
protocol -
Der Parameter
protocolsetzt das spezifische Protokoll innerhalb der angegebenendomain, das vom zurückgegebenen Socket für die Kommunikation benutzt wird. Der passende Wert kann ermittelt werden, indem der Name des Protokolls an die Funktion getprotobyname() übergeben wird. Wenn TCP oder UDP gewünscht werden, können auch die entsprechenden KonstantenSOL_TCPundSOL_UDPbenutzt werden.Gebräuchliche Protokolle Name Beschreibung icmp Das Internet Control Message Protocol wird hauptsächlich von Gateways und Hosts benutzt, um Kommunikationsfehler bei Datagrammen 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 Oktet-Grenzen der darunterliegenden Datagramm-Kommunikationschicht bestimmen kann. Aus diesem Grund müssen TCP Anwendungen in der Lage sein, auch Teilübertragungen empfangen zu können.
Rückgabewerte
Bei Erfolg gibt socket_create() eine
Socket-Instanz zurück, bei einem Fehler wird false
zurückgegeben. Der aktuelle Fehlercode kann mit
socket_last_error() ermittelt und an die Funktion
socket_strerror() übergeben werden, um eine textuelle
Beschreibing des Fehlers zu erhalten.
Fehler/Exceptions
Falls eine ungültige domain oder ein ungültiger
type angegbeben wird, fällt
socket_create() auf seine Standardeinstellungen
AF_INET bzw. SOCK_STREAM zurück,
und gibt zusätzlich eine E_WARNING-Meldung aus.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 | Bei Erfolg gibt diese Funktion nun eine Socket-Instanz zurück; zuvor wurde eine Ressource zurückgegeben. |
Siehe auch
- socket_accept() - Akzeptiert eine Verbindung an einem Socket
- socket_bind() - Verknüpft einen Socket mit einem Namen
- socket_connect() - Baut eine Verbindung über einen Socket auf
- socket_listen() - Hört einen Socket nach Verbindungsanforderungen ab
- socket_last_error() - Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist
- socket_strerror() - Gibt einen String zurück, der einen Socket-Fehler beschreibt
