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

socket_last_error(?Socket $socket = null): int

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.

Parameter-Liste

socket: Eine Socket-Instanz, die mit socket_create() erzeugt wurde.

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.