socket_recvfrom
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_recvfrom — Empfängt Daten von einem Socket, egal, ob verbindungsorientiert oder nicht
Beschreibung
Socket
$socket
,string
&$data
,int
$length
,int
$flags
,string
&$address
,int
&$port
= null
): int|false
Die Funktion socket_recvfrom() empfängt über den Socket
socket
length
Bytes von
address
über den Port port
(falls der Socket nicht vom Typ AF_UNIX
ist) und liest
sie in den Puffer data
ein.
socket_recvfrom() kann dazu verwendet werden, um Daten
sowohl von verbundenen als auch unverbundenen Sockets zu lesen. Außerdem
können ein oder mehrere Flags gesetzt werden, um das Verhalten dieser
Funktion zu beeinflussen.
Die Parameter address
und port
müsssen als Referenz übergeben werden. Wenn der Socket verbindungslos ist,
wird address
auf die Internet-Protokolladresse des
entfernten Host oder auf den Pfad zum UNIX-Socket gesetzt. Ist der Socket
verbindungsorientiert, ist address
null
. Zusätzlich
enthält der Parameter port
den Port des entfernten
Host, falls es sich um einen nicht verbundenen AF_INET
oder AF_INET6
-Socket handelt.
Hinweis: Diese Funktion ist binärsicher.
Parameter-Liste
-
socket
-
socket
muss eine Socket-Instanz sein, die zuvor mit socket_create() erzeugt wurde. -
data
-
Die empfangenen Daten werden in die Variable
data
eingelesen. -
length
-
Bis zu
length
Bytes werden vom entfernten Host gelesen. -
flags
-
Der Wert von
flags
kann eine beliebige Kombination der folgenden Flags sein, die mit dem binären OR (|
) verknüpft werden.Mögliche Werte für flags
Flag Beschreibung MSG_OOB
Verarbeite bandexterne Daten. MSG_PEEK
Lies Daten ab Anfang der Empfangs-Warteschlange, ohne die Daten aus der Warteschlange zu löschen. MSG_WAITALL
Blockiere so lange, bis mindestens length
Daten gelesen wurden. Wenn jedoch ein Signal empfangen wurde oder der entfernte Host die Verbindung beendet, kann die Funktion auch weniger Daten zurückgeben.MSG_DONTWAIT
Wenn dieses Flag gesetzt ist, kehrt die Funktion zurück, auch wenn sie normalerweise blockieren würde. -
address
-
Wenn der Socket vom Typ
AF_UNIX
ist, enthältaddress
den Pfad zu einer Datei. Anderenfalls, bei nicht verbundenen Sockets, enthältaddress
die IP-Adresse des entfernten Hosts odernull
, falls der Socket verbindungsorientiert ist. -
port
-
Dieses Argument gilt nur für Sockets vom Typ
AF_INET
undAF_INET6
und gibt den entfernten Port an, über den Daten empfangen werden. Falls der Socket verbindungsorientiert ist, istport
null
.
Rückgabewerte
socket_recvfrom() gibt die Anzahl der empfangenen Bytes
zurück oder false
, falls ein Fehler auftrat. Der aktuelle Fehlercode kann
mit socket_last_error() abgefragt werden. Dieser
Fehlercode kann an die Funktion socket_strerror()
übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
socket ist nun eine
Socket-Instanz; vorher war es eine
resource.
|
Beispiele
Beispiel #1 socket_recvfrom()-Beispiel
<?php
$socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
socket_bind($socket, '127.0.0.1', 1223);
$from = '';
$port = 0;
socket_recvfrom($socket, $buf, 12, 0, $from, $port);
echo "$buf von entfernter Adresse $from über den entfernten Port $port empfangen." . PHP_EOL;
?>
Dieses Beispiel erzeugt einen UDP-Socket über Port 1223 des Hosts 127.0.0.1 und gibt höchstens 12 Zeichen aus, die von einem entfernten Host empfangen wurden.
Siehe auch
- socket_recv() - Empfängt Daten von einem verbundenen Socket
- socket_send() - Sendet Daten an einen verbundenen Socket
- socket_sendto() - Sendet eine Nachricht an einen Socket, egal ob dieser verbunden ist oder nicht
- socket_create() - Erzeugt einen Socket (Endpunkt für die Kommunikation)