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(9mo ago)1160.2k↑14.2%[1 PRs](https://github.com/alleyinteractive/wp-fatal-handler/pulls)GPL-2.0-or-laterPHPPHP ^8.2CI passing Since Jun 25Pushed 1mo 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 1mo ago READMEChangelog (4)Dependencies (7)Versions (8)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 45 — FairBetter than 93% of packages Maintenance76 Regular maintenance activity Popularity36 Limited adoption so far Community10 Small or concentrated contributor base Maturity44 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 277d 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 [civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 728272.9k20](/packages/civicrm-civicrm-core)[cognesy/instructor-php The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control 310107.9k1](/packages/cognesy-instructor-php)[alleyinteractive/wp-block-converter Convert HTML into Gutenberg Blocks with PHP 62321.0k1](/packages/alleyinteractive-wp-block-converter)[alleyinteractive/wp-curate Plugin to curate homepages and other landing pages 10154.3k](/packages/alleyinteractive-wp-curate)[alleyinteractive/feed-consumer Ingest external feeds and other data sources into WordPress 114.8k](/packages/alleyinteractive-feed-consumer)[ffi/var-dumper List of symfony/var-dumper casters with FFI support 2010.7k4](/packages/ffi-var-dumper) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)