socket_create

socket_create -- Erzeugt einen Socket (Endpunkt für die Kommunikation)

Beschreibung

resource socket_create ( int domain, int type, int protocol)

Warnung

Diese Funktion ist EXPERIMENTELL . Das Verhalten , der Funktionsname und alles Andere was hier dokumentiert ist , kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern . Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko .

Erzeugt einen Kommunikationsendpunkt ( einen Socket ) und gibt einen Socket-Deskriptor zurück .

Der domain Parameter legt die Domain fest ( Protokoll-Familie ) , die für die Kommunikation benutzt wird . Gegenwärtig verstehen Sockets AF_INET und AF_UNIX . AF_INET wird normalererweise für die Internet-Kommunikation benutzt . AF_UNIX verwendet Pfadnamen zur Identifikation von Sockets und kann daher nur für die lokale Kommunikation benutzt werden ( welche andererseits schneller ist ) .

Der type Parameter bestimmt den Socket-Typ . Dies ist entweder SOCK_STREAM , SOCK_DGRAM , SOCK_SEQPACKET , SOCK_RAW , SOCK_RDM oder SOCK_PACKET . Die beiden meistbenutzten Typen sind SOCK_DGRAM für die ( verbindungslose ) UDP Kommunikation , und SOCK_STREAM für die TCP Kommunikation .

protocol gibt das Protokoll an , welches entweder SOL_UDP oder SOL_TCP ist .

Bei Erfolg gibt die Funktion einen Socket-Deskriptor zurück , bei einem Fehler wird FALSE zurückgegeben . Der aktuelle Fehlercode kann mit socket_last_error( ) ermittelt werden . Dieser Fehlercode kann an die Funktion socket_strerror( ) übergeben werden , um eine textuelle Beschreibing des Fehlers zu erhalten .

Weitere Informationen über die Benutzung der Funktion socket_create( ) , als auch über die Bedeutung der verschiedenen Parameter finden Sie auf der Unix man page socket (2 ) .

Anmerkung : Falls ein fehlerhafter domain - oder type -Parameter angegeben wird , benutzt socket_create( ) standardmässig AF_INET sowie SOCK_STREAM und gibt eine E_WARNING -Meldung aus .

Siehe auch socket_accept( ) , socket_bind( ) , socket_connect( ) , socket_listen( ) , socket_last_error( ) und socket_strerror( ) .