PHPackages alleyinteractive/wp-fatal-handler - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. alleyinteractive/wp-fatal-handler ActiveWordpress-plugin[Utility & Helpers](/categories/utility) alleyinteractive/wp-fatal-handler ================================= A better fatal error handler for WordPress. v0.1.3(10mo ago)1234.8k↓25.1%[3 PRs](https://github.com/alleyinteractive/wp-fatal-handler/pulls)GPL-2.0-or-laterPHPPHP ^8.2CI passing Since Jun 25Pushed 1w ago1 watchersCompare [ Source](https://github.com/alleyinteractive/wp-fatal-handler)[ Packagist](https://packagist.org/packages/alleyinteractive/wp-fatal-handler)[ Docs](https://github.com/alleyinteractive/wp-fatal-handler)[ RSS](/packages/alleyinteractive-wp-fatal-handler/feed)WikiDiscussions develop Synced 2d ago READMEChangelog (4)Dependencies (7)Versions (11)Used By (0) WP Fatal Error Handler ====================== [](#wp-fatal-error-handler) Contributors: alleyinteractive Tags: alleyinteractive, wp-fatal-handler Stable tag: 0.1.3 Requires at least: 6.3 Tested up to: 6.7 Requires PHP: 8.2 License: GPL v2 or later [![Testing Suite](https://github.com/alleyinteractive/wp-fatal-handler/actions/workflows/all-pr-tests.yml/badge.svg)](https://github.com/alleyinteractive/wp-fatal-handler/actions/workflows/all-pr-tests.yml) A better fatal error handler for WordPress powered by [Whoops](https://github.com/filp/whoops). [![Screenshot of plugin](./screenshots/screenshot.png)](./screenshots/screenshot.png) By default, WordPress' error handling provides limited information when dealing with fatal errors. [![Screenshot of core](./screenshots/core-error.png)](./screenshots/core-error.png) This plugin replaces the default WordPress fatal error handler with a Whoops error handler, which provides a much more useful error page with stack traces, code snippets, and more. It also provides a JSON response for API requests. The Whoops handler will only be applied to fatal errors where `WP_DEBUG` is set to `true. Installation ------------ [](#installation) You can install the package via Composer: ``` composer require alleyinteractive/wp-fatal-handler ``` Usage ----- [](#usage) Activate the plugin in WordPress and it will automatically register the Whoops error handler for fatal errors. It is recommended to load this plugin as early as possible (perhaps in `mu-plugins`), so that it can catch all fatal errors that occur during the WordPress bootstrap process. Configuration ------------- [](#configuration) By default the plugin will register the Whoops error handler and only handle fatal errors (where core usually displays `There has been a critical error on this website.` ). To disable the registration of the error handler, you can use the `wp_fatal_handler_register` filter: ``` add_filter( 'wp_fatal_handler_register', '__return_false' ); ``` **Note:** this filter should be applied before the plugin is loaded. Conflict with Query Monitor --------------------------- [](#conflict-with-query-monitor) By default Query Monitor will handle fatal errors which will prevent this plugin from displaying its error page. To allow this plugin to handle fatal errors, you can disable Query Monitor's error handling by using the following code: ``` define( 'QM_DISABLE_ERROR_HANDLER', true ); ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) This project is actively maintained by [Alley Interactive](https://github.com/alleyinteractive). Like what you see? [Come work with us](https://alley.com/careers/). - [Sean Fisher](https://github.com/srtfisher) - [All Contributors](../../contributors) License ------- [](#license) The GNU General Public License (GPL) license. Please see [License File](LICENSE) for more information. ### Health Score 46 — FairBetter than 92% of packages Maintenance78 Regular maintenance activity Popularity37 Limited adoption so far Community10 Small or concentrated contributor base Maturity46 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~16 days Total 4 Last Release 323d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/338d27065b1074f2d66d049d742f22996dd137eef6f91bc8f75350ceee1e8ef2?d=identicon)[srtfisher](/maintainers/srtfisher) --- Top Contributors [![srtfisher](https://avatars.githubusercontent.com/u/346399?v=4)](https://github.com/srtfisher "srtfisher (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)") --- Tags wordpresswordpress-pluginalleyinteractivewp-fatal-handler ### Code Quality Static AnalysisRector ### Embed Badge ![Health badge](/badges/alleyinteractive-wp-fatal-handler/health.svg) ``` [![Health](https://phpackages.com/badges/alleyinteractive-wp-fatal-handler/health.svg)](https://phpackages.com/packages/alleyinteractive-wp-fatal-handler) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 751291.4k43](/packages/civicrm-civicrm-core)[alleyinteractive/mantle-framework A framework for powerful WordPress development 28325.2k2](/packages/alleyinteractive-mantle-framework)[alleyinteractive/wp-block-converter Convert HTML into Gutenberg Blocks with PHP 65422.1k2](/packages/alleyinteractive-wp-block-converter)[alleyinteractive/wp-curate Plugin to curate homepages and other landing pages 11235.0k](/packages/alleyinteractive-wp-curate)[alleyinteractive/wp-alleyvate Defaults for WordPress sites by Alley. 3442.6k](/packages/alleyinteractive-wp-alleyvate) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)