socket_create

PHP Handbuch
Zurück		Weiter

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().

Zurück	Zum Anfang	Weiter
socket_create_pair	Nach oben	socket_get_option