PHP Handbuch
Zurück |  | Nach vorne

# socket_create

(PHP 4 >= 4.1.0)

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

Zurück | Zum Anfang | Nach vorne
socket_create_pair | Nach oben | socket_get_option