joseph-lenton / php-error
Better error reporting for PHP, and prettier too!
Installs: 77 612
Dependents: 4
Suggesters: 0
Security: 0
Stars: 1 353
Watchers: 86
Forks: 151
Open Issues: 41
Requires
- php: >=5.3.0
This package is not auto-updated.
Last update: 2024-11-03 04:28:11 UTC
README
THIS IS NO LOBGER MAINTAINED, Please leave me alone.
PHP errors are not good enough for development, it's as simple as that. This aims to solve this.
When an error strikes, the page is replaced with a full stack trace, syntax highlighting, and all displayed to be readable.
Works with Ajax too!
If the server errors during an ajax request, then the request is paused, and the error is displayed in the browser. You can then click to automatically retry the last request.
This requires no changes to your JavaScript, and works with existing JS libraries such as jQuery.
Do not use on a live site!
To help make development easier, this deliberately makes your code unsafe. External requests are allowed to change your code, it shows more about your site, gives you more info, and makes trivial errors fatal. All of that is awesome if you want to fix bugs in less time, but in production, it is totally unsafe.
seriously, only use this for development!
In case you forget, you can disable this in production using the 'php_error.force_disabled' php.ini option (see below).
Features
- trivial to use, it's just one file
- errors displayed in the browser for normal and ajaxy requests
- ajax requests are paused, allowing you to automatically re-run them
- makes errors as strict as possible (encourages code quality, and tends to improve performance)
- code snippets across the whole stack trace
- provides more information (such as full function signatures)
- fixes some error messages which are just plain wrong
- syntax highlighting
- looks pretty!
Getting Started
- Download, it's just one file.
- Place it in your project.
- import php_error.php
- call \php_error\reportErrors()
<?php require( 'php_error.php' ); \php_error\reportErrors(); ?>
Documentation
Example Setup
API
Options
php.ini settings
Advanced Features
- customization
- manually turn it on and off
- run specific sections without error reporting
- ignore files allowing you to avoid highlighting code in your stack trace
- application files; these are prioritized when an error strikes!