socket_last_error
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_last_error — Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist
Beschreibung
Wenn eine Socket-Instanz an diese Funktion übergeben
wird, wird der letzte Fehler, der an diesem bestimmten Socket aufgetreten
ist, zurückgegeben. Falls socket
null
ist, wird
der Fehlercode der letzten fehlgeschlagenen Socket-Funktion zurückgegeben.
Letzteres ist besonders hilfreich für Funktionen wie
socket_create(), die bei einem Fehler keinen Socket
zurückgibt, oder socket_select(), die aus anderen
Gründen, die nichts mit einem bestimmten Socket zu tun haben, fehlschlagen
kann. Der Fehlercode kann an die Funktion
socket_strerror() übergeben werden, die eine textuelle
Beschreibung dieses Fehlercodes zurückgibt.
Trat kein Fehler auf, oder der Fehler wurde per
socket_clear_error() gelöscht, dann gibt die Funktion
0
zurück.
Rückgabewerte
Diese Funktion gibt den Fehlercode eines Socket-Fehlers zurück.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
socket ist nun eine
Socket-Instanz; vorher war es eine
resource.
|
8.0.0 |
socket ist nun ein Nullable-Typ.
|
Beispiele
Beispiel #1 socket_last_error()-Beispiel
<?php
$socket = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
$errorcode = socket_last_error();
$errormsg = socket_strerror($errorcode);
die("Konnte keinen Socket erzeugen: [$errorcode] $errormsg");
}
?>
Anmerkungen
Hinweis:
socket_last_error() löscht den Fehlercode nicht. Dazu müssesn Sie socket_clear_error() aufrufen.