error_get_last

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

error_get_lastLiefert den zuletzt aufgetretenen Fehler

Beschreibung

error_get_last(): ?array

Liefert Informationen über den zuletzt aufgetretenen Fehler

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rückgabewerte

Gibt ein assoziatives Array zurück das den zuletzt aufgetretenen Fehler mit den Elementen "type" (für die Art des Fehlers), "message" (für die Fehlermeldung) sowie "file" und "line" (für den Ort an dem der Fehler aufgetreten ist) beschreibt. Wenn bisher noch kein Fehler aufgetreten ist, wird null zurückgegeben.

Beispiele

Beispiel #1 error_get_last()-Beispiel

<?php
echo $a;
print_r(error_get_last());
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [type] => 8
    [message] => Undefined variable: a
    [file] => C:\WWW\index.php
    [line] => 2
)

add a note add a note

User Contributed Notes 14 notes

up
20
dmgx dot michael at gmail dot com
14 years ago
If an error handler (see set_error_handler ) successfully handles an error then that error will not be reported by this function.
up
14
nicolas dot grekas+php at gmail dot com
11 years ago
[Editor's note: as of PHP 7.0.0 there is error_clear_last() to clear the most recent error.]

To clear error_get_last(), or put it in a well defined state, you should use the code below. It works even when a custom error handler has been set.

<?php

// var_dump or anything else, as this will never be called because of the 0
set_error_handler('var_dump', 0);
@
$undef_var;
restore_error_handler();

// error_get_last() is now in a well known state:
// Undefined variable: undef_var

... // Do something

$e = error_get_last();

...

?>
up
9
Skrol29
14 years ago
Function error_get_last() will return an error information even if the error is hidden because you've used character @, because of  the "error_reporting" directive in the php.ini file, or because you've used function error_reporting().

Examples:

<?php
error_reporting
(E_ALL ^ E_NOTICE);
$y = $x;
$err = error_get_last();
var_export($err);
?>
Will display: array ( 'type' => 8, 'message' => 'Undefined variable: x', 'file' => 'test.php', 'line' => 4, )

<?php
$y
= @$x;
$err = error_get_last();
var_export($err);
?>
Will display: array ( 'type' => 8, 'message' => 'Undefined variable: x', 'file' => 'test.php', 'line' => 4, )
up
8
michael at getsprink dot com
15 years ago
The error_get_last() function will give you the most recent error even when that error is a Fatal error.

Example Usage:

<?php

register_shutdown_function
('handleFatalPhpError');

function
handleFatalPhpError() {
  
$last_error = error_get_last();
   if(
$last_error['type'] === E_ERROR) {
      echo
"Can do custom output and/or logging for fatal error here...";
   }
}

?>
up
2
iant at clickwt dot com
15 years ago
Beware that registing a shutdown function to catch errors won't work if other shutdown functions throw errors.

<?php

register_shutdown_function
('cleanupObjects');
register_shutdown_function('handleFatalPhpError');

function
cleanupObjects() {
  
trigger_error('An insignificant problem', E_USER_WARNING);
}

function
handleFatalPhpError() {
  
$last_error = error_get_last();
   if(
$last_error['type'] === E_ERROR || $last_error['type'] === E_USER_ERROR) {
      echo
"Can do custom output and/or logging for fatal error here...";
   }
}

trigger_error('Something serious', E_USER_ERROR);

?>

In the above code, $last_error will contain the warning, becuase cleanupObjects() is called first.
up
3
php at joert dot net
13 years ago
To simulate this function in a horrid way for php <5.2, you can use something like this.
<?php
if( !function_exists('error_get_last') ) {
   
set_error_handler(
       
create_function(
           
'$errno,$errstr,$errfile,$errline,$errcontext',
           
'
                global $__error_get_last_retval__;
                $__error_get_last_retval__ = array(
                    \'type\'        => $errno,
                    \'message\'        => $errstr,
                    \'file\'        => $errfile,
                    \'line\'        => $errline
                );
                return false;
            '
       
)
    );
    function
error_get_last() {
        global
$__error_get_last_retval__;
        if( !isset(
$__error_get_last_retval__) ) {
            return
null;
        }
        return
$__error_get_last_retval__;
    }
}
?>
up
1
vike2000 at google mail domain
11 years ago
To know if something happened between two statements one can of course use a special string with user_error() (in lieu of a built-in special reset mentioned by mail at mbaierl dot com): <?php
@user_error($error_get_last_mark='error_get_last mark');
$not_set;
$error_get_last=error_get_last();
$something_happened=($error_get_last['message']!=$error_get_last_mark); ?>

If your <?php set_error_handler(function) ?> function returns true then you'll have to roll you own error_get_last functionality. (Shortly mentioned by dmgx dot michael at gmail dot com).

To manual moderators: Re php.net/manual/add-note.php: Since i guess the above technically sorts under "References to other notes" i feel the need to defend myself with that i'm thinking it might show for usability where other's say it fails and no, i haven't got any other medium to reach the readers of the php manual notes.
Also, you could have some examples of what notes you think is okay. Thanks for your moderation.
up
1
Brad
16 years ago
Like $php_errormsg, the return value of this function may not be updated if a user-defined error handler returns non-FALSE. Tested on PHP 5.2.6.

<?php
var_dump
(PHP_VERSION);
// Outputs: string(5) "5.2.6"

@trigger_error("foo");
$e=error_get_last();
var_dump($e['message']);
// Outputs: string(3) "foo"

set_error_handler(create_function('$a,$b',''));

@
trigger_error("bar");
$e=error_get_last();
var_dump($e['message']);
// Outputs: string(3) "foo"

set_error_handler(create_function('$a,$b','return false;'));

@
trigger_error("baz");
$e=error_get_last();
var_dump($e['message']);
// Outputs: string(3) "baz"
?>
up
1
Brad
16 years ago
It can't be completely reset, but you can "clear" it well enough for all practical purposes:
<?php
@trigger_error("");
// do stuff...
$e=error_get_last();
if(
$e['message']!==''){
   
// An error occurred
}
?>
up
1
Krzysztof Przygoda
1 year ago
Be aware that error_get_last() returns only uncaught errors.
Caught ones will never get to the error_get_last(), i.e.:
- $error_levels registered with set_error_handler() when $callback does not return false,
- all exceptions, including errors not supported by set_error_handler() (like :E_ERROR/fatal error, E_PARSE, etc.) that are exceptions in fact,
  when set_exception_handler($callback) is registered,
- exceptions caught by try/catch block.
up
-1
admin at manomite dot net
7 years ago
This is a simple debugging script for mail functions...

<?php
//Built By Manomite for Debugging

class Error{

function
__construct(){

error_reporting ( E_ALL ^ E_NOTICE );
$err = error_get_last ();

if(
$err){

$res = "An error has occurred in your application sir.\n Details Include " .$err.""

mail("admin@manomite.net","Error Occurred",$res,$from);
}
}
}
?>
up
-3
scott at eyefruit dot com
14 years ago
If you have the need to check whether an error was a fatal error  before PHP 5.2 (in my case, within an output buffer handler), you can use the following hack:

<?php
# Check if there was a PHP fatal error.
# Using error_get_last is the "right" way, but it requires PHP 5.2+. The back-up is a hack.
if (function_exists('error_get_last')) {
   
$lastPHPError = error_get_last();
   
$phpFatalError = isset($lastPHPError) && $lastPHPError['type'] === E_ERROR;
} else {
   
$phpFatalError = strstr($output, '<b>Fatal error</b>:') && ! strstr($output, '</html>');
}
?>

This is, of course, language-dependent, so it wouldn't be good in widely-distributed code, but it may help in certain cases (or at least be the base of something that would work).
up
-9
mail at mbaierl dot com
16 years ago
This function is pretty useless, as it can not be reset, so there is no way to know if the error really happened on the line before this function call.
up
-4
phil at wisb dot net
16 years ago
While mail at mbaierl dot com makes the point that this function isn't best for reporting the possible error condition of the most recently executed step, there are situations in which it is especially helpful to know the last error—regardless of when it occurred.

As an example, imagine if you had some code that captured the output from dynamic pages, and cached it for faster delivery to subsequent visitors. A final sanity check would be to see if an error has occurred anywhere during the execution of the script. If there has been an error, we probably don't want to cache that page.
To Top