PHP TOP

error_reporting

(PHP 4, PHP 5, PHP 7, PHP 8)

error_reporting — 出力する PHP エラーの種類を設定する

説明

error_reporting(?int $error_level = null): int

error_reporting() 関数は、 error_reporting ディレクティブを実行時に設定します。PHP には多くのエラーレベルがあり、この関数によりスクリプトの持続時間(実行時間)のレベルが設定されます。オプションの error_level を指定しなかった場合は、 error_reporting() は単に現在のエラーレベルを返します。

パラメータ

error_level

新しい error_reporting レベル。ビットマスクまたは名前つき定数のどちらかです。将来のバージョンとの互換性を保証するために、名前つき定数の使用が強く推奨されています。エラーレベルが追加されると、整数の幅は増加します。そのため、以前の整数を使用するエラーレベルは常に期待通りに動作するとは限りません。

利用可能なエラーレベル定数とその実際の意味は、定義済みの定数に記述されています。

戻り値

error_level に変更される前の、 error_reporting レベルを返します。

注意: エラー制御演算子 @ は、エラーハンドリングの間に error_level を変更します。

変更履歴

バージョン	説明
8.0.0	`error_level` は、nullable になりました。

例

例1 error_reporting() の例

<?php

// 全てのエラー出力をオフにする
error_reporting(0);

// 単純な実行時エラーを表示する
error_reporting(E_ERROR | E_WARNING | E_PARSE);

// E_NOTICE を表示させるのもおすすめ（初期化されていない
// 変数、変数名のスペルミスなど…）
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

// E_NOTICE 以外の全てのエラーを表示する
error_reporting(E_ALL & ~E_NOTICE);

// 全ての PHP エラーを表示する
error_reporting(E_ALL);

// 全ての PHP エラーを表示する
error_reporting(-1);

// error_reporting(E_ALL); と同じ
ini_set('error_reporting', E_ALL);

?>

注意

ヒント

値に -1 を指定すると、仮に将来のバージョンの PHP で新しいレベルと定数が追加されたとしてもすべてのエラーを表示するようになります。 E_ALL 定数も、これと同じ挙動になります。

参考

display_errors ディレクティブ
html_errors ディレクティブ
xmlrpc_errors ディレクティブ
エラー制御演算子
ini_set() - 設定オプションの値を設定する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 27 notes

down

368

info at hephoz dot de ¶

16 years ago

If you just see a blank page instead of an error reporting and you have no server access so you can't edit php configuration files like php.ini try this:

- create a new file in which you include the faulty script:

<?php
 error_reporting(E_ALL);
 ini_set("display_errors", 1);
 include("file_with_errors.php");
?>

- execute this file instead of the faulty script file 

now errors of your faulty script should be reported.
this works fine with me. hope it solves your problem as well!

down

dave at davidhbrown dot us ¶

18 years ago

The example of E_ALL ^ E_NOTICE is a 'bit' confusing for those of us not wholly conversant with bitwise operators.

If you wish to remove notices from the current level, whatever that unknown level might be, use & ~ instead:

<?php
//....
$errorlevel=error_reporting();
error_reporting($errorlevel & ~E_NOTICE);
//...code that generates notices
error_reporting($errorlevel);
//...
?>

^ is the xor (bit flipping) operator and would actually turn notices *on* if they were previously off (in the error level on its left). It works in the example because E_ALL is guaranteed to have the bit for E_NOTICE set, so when ^ flips that bit, it is in fact turned off. & ~ (and not) will always turn off the bits specified by the right-hand parameter, whether or not they were on or off.

down

jcastromail at yahoo dot es ¶

3 years ago

Under PHP 8.0, error_reporting() does not return 0 when then the code uses a @ character.  

For example

<?php

$a=$array[20]; // error_reporting() returns 0 in php <8 and 4437 in PHP>=8

?>

down

lhenry at lhenry dot com ¶

5 years ago

In php7,  what was generally a notice or a deprecated is now a warning : the same level of a mysql error …  unacceptable for me.

I do have dozen of old projects and I surely d'ont want to define every variable which I eventually wrote 20y ago.

So two option: let php7 degrade my expensive SSDs writing Gb/hours or implement smthing like server level monitoring ( with auto_[pre-ap]pend_file in php.ini) and turn off E_WARNING

Custom overriding the level of php errors should be super handy and flexible …

down

ecervetti at orupaca dot fr ¶

15 years ago

It could save two minutes to someone:
E_ALL & ~E_NOTICE  integer value is 6135

down

Fernando Piancastelli ¶

20 years ago

The error_reporting() function won't be effective if your display_errors directive in php.ini is set to "Off", regardless of level reporting you set. I had to set

display_errors = On
error_reporting = ~E_ALL

to keep no error reporting as default, but be able to change error reporting level in my scripts.
I'm using PHP 4.3.9 and Apache 2.0.

down

&IT ¶

4 years ago

error_reporting(E_ALL);
if (!ini_get('display_errors')) {
    ini_set('display_errors', '1');
}

down

vdephily at bluemetrix dot com ¶

19 years ago

Note that E_NOTICE will warn you about uninitialized variables, but assigning a key/value pair counts as initialization, and will not trigger any error :
<?php
error_reporting(E_ALL);

$foo = $bar; //notice : $bar uninitialized

$bar['foo'] = 'hello'; // no notice, although $bar itself has never been initialized (with "$bar = array()" for example)

$bar = array('foobar' => 'barfoo');
$foo = $bar['foobar'] // ok

$foo = $bar['nope'] // notice : no such index
?>

down

chris at ocproducts dot com ¶

8 years ago

The error_reporting() function will return 0 if error suppression is currently active somewhere in the call tree (via the @ operator).

down

keithm at aoeex dot com ¶

14 years ago

Some E_STRICT errors seem to be thrown during the page's compilation process.  This means they cannot be disabled by dynamically altering the error level at run time within that page.

The work-around for this was to rename the file and replace the original with a error_reporting() call and then a require() call.

Ex, rename index.php to index.inc.php, then re-create index.php as:

<?php
error_reporting(E_ALL & ~(E_STRICT|E_NOTICE));
require('index.inc.php');
?>

That allows you to alter the error reporting prior to the file being compiled.

I discovered this recently when I was given code from another development firm that triggered several E_STRICT errors and I wanted to disable E_STRICT on a per-page basis.

down

huhiko334 at yandex dot ru ¶

6 years ago

If you get a weird mysql warnings like "Warning: mysql_query() : Your query requires a full tablescan...", don't look for error_reporting settings - it's set in php.ini.
You can turn it off with
ini_set("mysql.trace_mode","Off");
in your script
http://tinymy.link/mctct

down

kevinson112 at yahoo dot com ¶

6 years ago

I had the problem that if there was an error, php would just give me a blank page.  Any error at all forced a blank page instead of any output whatsoever, even though I made sure that I had error_reporting set to E_ALL, display_errors turned on, etc etc.  But simply running the file in a different directory allowed it to show errors!

Turns out that the error_log file in the one directory was full (2.0 Gb).  I erased the file and now errors are displayed normally.  It might also help to turn error logging off.

https://techysupport.co/norton-tech-support/

down

adam at adamhahn dot com ¶

7 years ago

To expand upon the note by chris at ocproducts dot com. If you prepend @ to error_reporting(), the function will always return 0.

<?php
error_reporting(E_ALL);
var_dump(
    error_reporting(), // value of E_ALL,
    @error_reporting() // value is 0
);
?>

down

j dot schriver at vindiou dot com ¶

24 years ago

error_reporting() has no effect if you have defined your own error handler with set_error_handler()



[Editor's Note: This is not quite accurate.



E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR and E_COMPILE_WARNING error levels will be handled as per the error_reporting settings.



All other levels of errors will be passed to the custom error handler defined by set_error_handler().



Zeev Suraski suggests that a simple way to use the defined levels of error reporting with your custom error handlers is to add the following line to the top of your error handling function:



if (!($type & error_reporting())) return;



 -zak@php.net]

down

qeremy ! gmail ¶

9 years ago

If you want to see all errors in your local environment, you can set your project URL like "foo.com.local" locally and put that in bootstrap file.

<?php
if (substr($_SERVER['SERVER_NAME'], -6) == '.local') {
    ini_set('display_errors', 1);
    ini_set('error_reporting', E_ALL);
    // or error_reporting(E_ALL);
}
?>

down

rojaro at gmail dot com ¶

14 years ago

To enable error reporting for *ALL* error messages including every error level (including E_STRICT, E_NOTICE etc.), simply use:

<?php error_reporting(-1); ?>

down

DarkGool ¶

19 years ago

In phpinfo() error reporting level display like a bit (such as 4095)



Maybe it is a simply method to understand what a level set on your host

if you are not have access to php.ini file



<?php

$bit = ini_get('error_reporting');

while ($bit > 0) {

    for($i = 0, $n = 0; $i <= $bit; $i = 1 * pow(2, $n), $n++) {

        $end = $i;

    }

    $res[] = $end;

    $bit = $bit - $end;

}

?>



In $res you will have all constants of error reporting

$res[]=int(16) // E_CORE_ERROR 

$res[]=int(8)    // E_NOTICE 

...

Atelier ”慶”

WEBクリエイター歴２０年、最先端技術と安心をお届けします。

PHPのお勉強！

error_reporting

説明

パラメータ

戻り値

変更履歴

例

注意

参考

Found A Problem?

User Contributed Notes 27 notes