I have checked my PHP ini file (php.ini
) and display_errors
is set and also error reporting is E_ALL
. I have restarted my Apache webserver.
I have even put these lines at the top of my script, and it doesn't even catch simple parse errors. For example, I declare variables with a "$"
and I don't close statements";"
. But all my scripts show a blank page on these errors, but I want to actually see the errors in my browser output.
error_reporting(E_ALL);
ini_set('display_errors', 1);
What is left to do?
27 Answers 27
DEV environment
This always works for me:
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
However, this doesn't make PHP to show parse errors occurred in the same file. Also, these settings can be overridden by PHP. In these cases the only way to show those errors is to modify your php.ini (or php-fpm.conf) with this line:
display_errors = on
(if you don't have access to php.ini
, then putting this line in .htaccess
might work too):
php_flag display_errors 1
PROD environment
Note that above recommendation is only suitable for the DEV environment. On a live site it must be
display_errors = off
log_errors = on
And then you'll be able to see all errors in the error log. See Where to find PHP error log
AJAX calls
In case of AJAX call, on a DEV server, open DevTools (F12), then Network tab. Then initiate the request which result you want to see, and it will appear in the Network tab. Click on it and then the Response tab. There you will see the exact output.
While on a live server just check the error log all the same.
-
11Also note that you can use these 3 lines, and then include('fileImWorkingOn.php');. Then you can catch the syntax errors too!Snap– Snap05/08/2015 18:11:29Commented May 8, 2015 at 18:11
-
18While I'm no SysOps, I think more people have an .htaccess file than php.ini, and these would both come before parsing, right?
php_flag display_errors 1
for .htaccessRyan Taylor– Ryan Taylor07/09/2015 21:58:58Commented Jul 9, 2015 at 21:58 -
1So now that the errors get logged, where do they go? I went to /var/log/apache2 and it shows all the logs, but there is no information regarding the program I recently ran. I only get information about system restarts once every morning.Michael– Michael05/17/2016 15:14:28Commented May 17, 2016 at 15:14
-
3
E_ALL
isn't sufficient to display all errors in PHP 5.3. "E_STRICT
became part ofE_ALL
in 5.4.0" - PHP Manual You needE_ALL | E_STRICT
or-1
in that version.Gerard Roche– Gerard Roche09/14/2016 04:12:24Commented Sep 14, 2016 at 4:12 -
2Everyone has a
PHP.ini
, Few have a.htaccess
file ... The ability to edit their PHP.ini file is another thing.. And most public servers allow for a custom php.ini file to be used..Angry 84– Angry 8411/10/2016 05:47:41Commented Nov 10, 2016 at 5:47
You can't catch parse errors in the same file where error output is enabled at runtime, because it parses the file before actually executing anything (and since it encounters an error during this, it won't execute anything). You'll need to change the actual server configuration so that display_errors is on and the approriate error_reporting level is used. If you don't have access to php.ini, you may be able to use .htaccess or similar, depending on the server.
This question may provide additional info.
Inside your php.ini:
display_errors = on
Then restart your web server.
-
10+1. On my ubuntu /etc/php5/apache2/php.inia pfp with melon– a pfp with melon02/23/2015 17:44:10Commented Feb 23, 2015 at 17:44
-
7for restart (Debian, Ubuntu, etc.)
sudo service apache2 restart
Peter Krauss– Peter Krauss09/01/2015 13:04:26Commented Sep 1, 2015 at 13:04 -
4For restart on OS X
sudo apachectl -k restart
.Pea– Pea01/10/2016 19:53:17Commented Jan 10, 2016 at 19:53 -
5fun fact: you can locate your php.ini file loaded if you simply put in phpinfo(); into a blank php file. it's the 7th row down and called
Loaded Configuration File
Frankenmint– Frankenmint07/24/2016 04:56:50Commented Jul 24, 2016 at 4:56 -
This doesn't work for me. In fact I can call
ini_get('display_errors')
and it returns an empty string (meaning it is turned off). And yes I checked to make sure it is the only line in the configuration file. The setting is getting overridden somehow and I can't figure out why and it is driving me nuts. Yes, I've searched everything in/etc/php.d/
and it is not one of those files either. Yes, I restarted the web server too. No, there is nothing in the.htaccess
file. I'm using PHP 7.4.6.cazort– cazort08/03/2021 18:07:11Commented Aug 3, 2021 at 18:07
To display all errors you need to:
1. Have these lines in the PHP script you're calling from the browser (typically index.php
):
error_reporting(E_ALL);
ini_set('display_errors', '1');
2.(a) Make sure that this script has no syntax errors
—or—
2.(b) Set display_errors = On
in your php.ini
Otherwise, it can't even run those 2 lines!
You can check for syntax errors in your script by running (at the command line):
php -l index.php
If you include the script from another PHP script then it will display syntax errors in the included script. For example:
index.php
error_reporting(E_ALL);
ini_set('display_errors', '1');
// Any syntax errors here will result in a blank screen in the browser
include 'my_script.php';
my_script.php
adjfkj // This syntax error will be displayed in the browser
-
All I get when doing php -l phpfilename.php is a message that says "Errors parsing sql_lab.php". It doesn't tell me what the errors are.KevinHJ– KevinHJ07/23/2021 02:33:27Commented Jul 23, 2021 at 2:33
-
In addition to the blank screen it will return an Error 500 which is way more safe to measure than just no content.Chris S.– Chris S.12/21/2021 23:04:21Commented Dec 21, 2021 at 23:04
Some web hosting providers allow you to change PHP parameters in the .htaccess
file.
You can add the following line:
php_value display_errors 1
I had the same issue as yours and this solution fixed it.
-
And if you are in nginx environment then add the php value to your site (sites-available) configuration under the location ~\.php directive. fastcgi_param PHP_VALUE " error_reporting=E_ALL;\n display_errors=1;";Lazaros Kosmidis– Lazaros Kosmidis10/09/2018 07:25:14Commented Oct 9, 2018 at 7:25
Warning: the below answer is factually incorrect. Nothing has been changed in error handling, uncaught exceptions are displayed just like other errors. Suggested approach must be used with caution, because it outputs errors unconditionally, despite the display_error setting and may pose a threat by revealing the sensitive information to an outsider on a live site.
You might find all of the settings for "error reporting" or "display errors" do not appear to work in PHP 7. That is because error handling has changed. Try this instead:
try{
// Your code
}
catch(Error $e) {
$trace = $e->getTrace();
echo $e->getMessage().' in '.$e->getFile().' on line '.$e->getLine().' called from '.$trace[0]['file'].' on line '.$trace[0]['line'];
}
Or, to catch exceptions and errors in one go (this is not backward compatible with PHP 5):
try{
// Your code
}
catch(Throwable $e) {
$trace = $e->getTrace();
echo $e->getMessage().' in '.$e->getFile().' on line '.$e->getLine().' called from '.$trace[0]['file'].' on line '.$trace[0]['line'];
}
-
1Do you mean PHP7 or PHP7.1 ? I am confused, I tried as the validated answer proposed and it works, I think you are proposing something a bit different IMHO, indeed "no backward compatibility" and if you have to modify a full PHP < 7 code and need to add
try{} catch() {}
code everywhere in your already defined php code, I don't even want to think the mess that's going to be..vdegenne– vdegenne01/22/2017 11:22:11Commented Jan 22, 2017 at 11:22 -
@FancyJohn, this could help:
$bt = debug_backtrace(); print_r($bt);
.Frank Forte– Frank Forte03/23/2017 03:25:31Commented Mar 23, 2017 at 3:25 -
@ballangddang, I ran into the issue with PHP 7.0, where the only way I could get the error to display was using the try/catch blocks and specifically catching
Error
. If you rewrite all requests (except maybe JavaScript, CSS, Images, etc) to the index.php file, then have the try catch block there, it makes it easier. Yes, any system that does not have a single entry point would be a major headache to update.Frank Forte– Frank Forte03/23/2017 03:28:52Commented Mar 23, 2017 at 3:28 -
1Does PHP not show unhandled exceptions? Pretty sure it does?Martin Tournoij– Martin Tournoij06/05/2017 02:20:28Commented Jun 5, 2017 at 2:20
-
1This looks like a bad idea. Time to use (or write) a global exception handler.Paul Spiegel– Paul Spiegel02/05/2019 14:54:44Commented Feb 5, 2019 at 14:54
This will work:
<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);
?>
-
October 2020: This worked for me. So easy. No messing around with .htaccess or php.ini. When you're done, just comment it out or remove it. PHP 7.4Rob Moll– Rob Moll10/23/2020 14:18:41Commented Oct 23, 2020 at 14:18
Use:
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
This is the best way to write it, but a syntax error gives blank output, so use the console to check for syntax errors. The best way to debug PHP code is to use the console; run the following:
php -l phpfilename.php
Set this in your index.php file:
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
In order to display a parse error, instead of setting display_errors
in php.ini you can use a trick: use include.
Here are three pieces of code:
File: tst1.php
<?php
error_reporting(E_ALL);
ini_set('display_errors', 'On');
// Missing " and ;
echo "Testing
When running this file directly, it will show nothing, given display_errors
is set to 0 in php.ini.
Now, try this:
File: tst2.php
<?php
error_reporting(E_ALL);
ini_set('display_errors', 'On');
include ("tst3.php");
File: tst3.php
<?php
// Missing " and ;
echo "Testing
Now run tst2.php which sets the error reporting, and then include tst3. You will see:
Parse error: syntax error, unexpected end of file, expecting variable (T_VARIABLE) or ${ (T_DOLLAR_OPEN_CURLY_BRACES) or {$ (T_CURLY_OPEN) in tst3.php on line 4
-
1I've spent some time figuring this out. Why did they change php 5 behaviour?Hube– Hube12/17/2020 20:41:08Commented Dec 17, 2020 at 20:41
-
1This deserves more upvotes. The key in my case was to enable error reporting and defining an error handler in
init0.php
, and from that file includeinit1.php
, which can include other files with errors in them. It won't work if enabling error reporting in the same file that includes other files with errors in them.Magnus– Magnus12/29/2022 20:21:11Commented Dec 29, 2022 at 20:21 -
1The approach suggested is actually correct, but the explanation was wrong. Nothing has been changed in PHP7. Neither PHP5 or PHP3 was able to parse a file with a syntax error. The problem is a parse error, not a PHP version. And the solution proposed is good for any PHP version.Your Common Sense– Your Common Sense02/04/2023 08:29:14Commented Feb 4, 2023 at 8:29
-
I had a very big web site running PHP5 and using the php.ini setting, all errors were visible, which explain all other answers. When I updated to PHP7, without any other changes, it was not possible to see errors. So even the solution is good for every version, the other answers are correct for older version.Peter– Peter02/04/2023 13:09:32Commented Feb 4, 2023 at 13:09
Create a file called php.ini in the folder where your PHP file resides.
Inside php.ini add the following code (I am giving an simple error showing code):
display_errors = on
display_startup_errors = on
I would usually go with the following code in my plain PHP projects.
if(!defined('ENVIRONMENT')){
define('ENVIRONMENT', 'DEVELOPMENT');
}
$base_url = null;
if (defined('ENVIRONMENT'))
{
switch (ENVIRONMENT)
{
case 'DEVELOPMENT':
$base_url = 'http://localhost/product/';
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
break;
case 'PRODUCTION':
$base_url = 'Production URL'; /* https://google.com */
error_reporting(E_ALL);
ini_set('display_errors', 0);
ini_set('display_startup_errors', 0);
ini_set('log_errors', 1); // Mechanism to log errors
break;
default:
exit('The application environment is not set correctly.');
}
}
If, despite following all of the above answers (or you can't edit your php.ini file), you still can't get an error message, try making a new PHP file that enables error reporting and then include the problem file. eg:
error_reporting(E_ALL);
ini_set('display_errors', 1);
require_once('problem_file.php');
Despite having everything set properly in my php.ini
file, this was the only way I could catch a namespace error. My exact scenario was:
//file1.php
namespace a\b;
class x {
...
}
//file2.php
namespace c\d;
use c\d\x; //Dies because it's not sure which 'x' class to use
class x {
...
}
-
1No, the error reporting is not a loglevel, it is a bitfield. Using 999999 is a very bad idea, use some power-of-two minus 1, for example 2047!peterh– peterh07/17/2018 13:32:22Commented Jul 17, 2018 at 13:32
-
You're absolutely right, @peterh! I've changed it to E_ALL as this will enable reporting of all errors (except strict errors in php 5.4 and below).jxmallett– jxmallett07/18/2018 02:52:12Commented Jul 18, 2018 at 2:52
If you somehow find yourself in a situation where you can't modifiy the setting via php.ini
or .htaccess
you're out of luck for displaying errors when your PHP scripts contain parse errors. You'd then have to resolve to linting the files on the command line like this:
find . -name '*.php' -type f -print0 | xargs -0 -n1 -P8 php -l | grep -v "No syntax errors"
If your host is so locked down that it does not allow changing the value via php.ini
or .htaccess
, it may also disallow changing the value via ini_set
. You can check that with the following PHP script:
<?php
if( !ini_set( 'display_errors', 1 ) ) {
echo "display_errors cannot be set.";
} else {
echo "changing display_errors via script is possible.";
}
-
find . -name '*.php' -type f -exec php -l {} \; | grep -v 'No syntax errors detected'
is simplerscones– scones11/24/2017 13:27:54Commented Nov 24, 2017 at 13:27
You can do something like below:
Set the below parameters in your main index file:
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
Then based on your requirement you can choose which you want to show:
For all errors, warnings and notices:
error_reporting(E_ALL); OR error_reporting(-1);
For all errors:
error_reporting(E_ERROR);
For all warnings:
error_reporting(E_WARNING);
For all notices:
error_reporting(E_NOTICE);
For more information, check here.
-
What is the "main index file"? File
index.html
?Peter Mortensen– Peter Mortensen02/17/2019 09:26:38Commented Feb 17, 2019 at 9:26
You can add your own custom error handler, which can provide extra debug information. Furthermore, you can set it up to send you the information via email.
function ERR_HANDLER($errno, $errstr, $errfile, $errline){
$msg = "<b>Something bad happened.</b> [$errno] $errstr <br><br>
<b>File:</b> $errfile <br>
<b>Line:</b> $errline <br>
<pre>".json_encode(debug_backtrace(), JSON_PRETTY_PRINT)."</pre> <br>";
echo $msg;
return false;
}
function EXC_HANDLER($exception){
ERR_HANDLER(0, $exception->getMessage(), $exception->getFile(), $exception->getLine());
}
function shutDownFunction() {
$error = error_get_last();
if ($error["type"] == 1) {
ERR_HANDLER($error["type"], $error["message"], $error["file"], $error["line"]);
}
}
set_error_handler ("ERR_HANDLER", E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED);
register_shutdown_function("shutdownFunction");
set_exception_handler("EXC_HANDLER");
Accepted asnwer including extra options. In PHP files for in my DEVELOPMENT apache vhost (.htaccess if you can ensure it doesn't get into production):
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
However, this doesn't make PHP to show parse errors - the only way to show those errors is to modify your php.ini with this line:
display_errors = on
(if you don't have access to php.ini
, then putting this line in .htaccess
might work too):
// I've added some extra options that set E_ALL as per https://www.php.net/manual/en/errorfunc.configuration.php.
php_flag log_errors on
php_flag display_errors on
php_flag display_startup_errors on
php_value error_reporting 2147483647
php_value error_log /var/www/mywebsite.ext/logs/php.error.log
This code on top should work:
error_reporting(E_ALL);
However, try to edit the code on the phone in the file:
error_reporting =on
The best/easy/fast solution that you can use if it's a quick debugging, is to surround your code with catching exceptions. That's what I'm doing when I want to check something fast in production.
try {
// Page code
}
catch (Exception $e) {
echo 'Caught exception: ', $e->getMessage(), "\n";
}
-
For php7,
catch (Throwable $e)
is better... Or another catch block underneathcatch(Error $e)
Frank Forte– Frank Forte08/19/2017 02:58:11Commented Aug 19, 2017 at 2:58 -
This code is actually dangerous. UNDER NO CIRCUMSTANCES it should be used in the production environment. As it will leak the error message to anyone, not only the dev who added it . In the production environment all errors must be logged. So the developer can peek into the error log any time. An it will catch all errors, not only ones happened when the dev is refreshing the browser. Without the need of adding any code. Which makes this code not only dangerous but also useless.Your Common Sense– Your Common Sense02/04/2023 09:04:38Commented Feb 4, 2023 at 9:04
-
Bro, he is quick debugging not launching a website for error catching, being dangerous is irrelevant, nobody would prefer errors to show to clients instead of a blank page. And yes, we could write him a logger or check out what is he using to provide him with the right solution, but this is stackoverflow, it would take a lot of chat and interactions to know his specific needs. your common sense.Xakiru– Xakiru02/05/2023 07:45:36Commented Feb 5, 2023 at 7:45
<?php
// Turn off error reporting
error_reporting(0);
// Report runtime errors
error_reporting(E_ERROR | E_WARNING | E_PARSE);
// Report all errors
error_reporting(E_ALL);
// Same as error_reporting(E_ALL);
ini_set("error_reporting", E_ALL);
// Report all errors except E_NOTICE
error_reporting(E_ALL & ~E_NOTICE);
?>
While your site is live, the php.ini
file should have display_errors disabled for security reasons. However, for the development environment, display_errors can be enabled for troubleshooting.
Just write:
error_reporting(-1);
If you have Xdebug installed you can override every setting by setting:
xdebug.force_display_errors = 1;
xdebug.force_error_reporting = -1;
force_display_errors
Type: int, Default value: 0, Introduced in Xdebug>= 2.3 If this setting is set to 1 then errors will always be displayed, no matter what the setting of PHP's display_errors is.
force_error_reporting
Type: int, Default value: 0, Introduced in Xdebug>= 2.3 This setting is a bitmask, like error_reporting. This bitmask will be logically ORed with the bitmask represented by error_reporting to dermine which errors should be displayed. This setting can only be made in php.ini and allows you to force certain errors from being shown no matter what an application does with ini_set().
If it is on the command line, you can run php
with -ddisplay_errors=1
to override the setting in php.ini
:
php -ddisplay_errors=1 script.php
-
Thanks, this was what I was looking for. It also works with
php -l
, so you can check for syntax errors without running the code.mwfearnley– mwfearnley03/25/2025 10:04:21Commented Mar 25 at 10:04
In Unix CLI, it's very practical to redirect only errors to a file:
./script 2> errors.log
From your script, either use var_dump()
or equivalent as usual (both STDOUT and STDERR will receive the output), but to write only in the log file:
fwrite(STDERR, "Debug infos\n"); // Write in errors.log^
Then from another shell, for live changes:
tail -f errors.log
or simply
watch cat errors.log
-
How does that answer this question about PHP?Peter Mortensen– Peter Mortensen04/22/2020 14:45:50Commented Apr 22, 2020 at 14:45
Report all errors except E_NOTICE
error_reporting(E_ALL & ~E_NOTICE);
Display all PHP errors
error_reporting(E_ALL); or ini_set('error_reporting', E_ALL);
Turn off all error reporting
error_reporting(0);
If you are on a SharedHosting plan (like on hostgator)... simply adding
php_flag display_errors 1
into a .htaccess file and uploading it to the remote folder may not yield the actual warnings/errors that were generated on the server.
What you will also need to do is edit the php.ini
This is how you do it via cPanel (tested on hostgator shared hosting plan)
After logging into your cPanel, search for MultiPHP INI Editor. It is usually found under the SOFTWARE section in your cPanel list of items.
On the MultiPHP INI Editor page ...you can stay on the basic mode tab and just check the button on the line that says display_errors. Then click the Apply button to save.
IMPORTANT: Just remember to turn it back off when you are done debugging; because this is not recommended for public servers.
As it is not clear what OS you are on these are my 2 Windows cents.
If you are using XAMPP you need to manually create the logs
folder under C:\xampp\php
. Not your fault, ApacheFriends ommitted this.
To read and follow this file do.
Get-Content c:\xampp\php\logs\php_error_log -Wait
To do this in VSCode create a task in .vscode\tasks.json
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "Monitor php errors",
"type": "shell",
"command": "Get-Content -Wait c:\\xampp\\php\\logs\\php_error_log",
"runOptions": {
"runOn": "folderOpen"
}
}
]
and have it run on folder load.
Explore related questions
See similar questions with these tags.
$_REQUEST
parameter) these two lines will work most of the time.