crasivo/bitrix-whoops

Whoops library adapter for 1C-Bitrix

0.0.2 2025-09-14 18:56 UTC

Requires

• php: ^7.2 || ^8.0
• filp/whoops: ^2.18

MIT

• Crasivo Dev

• exception
• handling
• bitrix

README

Adapter for the popular Whoops library for 1C-Bitrix & Bitrix24. Used for visual debugging of errors in the public part of the project.

Implementation features:

• Simple and quick integration into an existing project
• Great for older versions
• Hiding "secret phrases" of environment variables (YourAwesomePa55 > ********)

Minimum requirements for installation:

• 1C-Bitrix kernel version (main): v20.5.400
• PHP version: v7.2
• Whoops version: v2.18

🚀 Quick Start

To use the library, you need to install the Composer package via the command:

$ cd /path/to/project
$ composer require crasivo/bitrix-whoops

Next, you need to register the handler via init.php. To do this, simply add one line of code to the specified file.

Crasivo\Bitrix\Whoops\ExceptionHandlerOutput::register();

To check the functionality, you need to activate the debug mode via the exception_handling.debug parameter in the .settings.php file and manually call an arbitrary Exception in the public part of the site.

📜 License

This project is distributed under the MIT license. The full text of the license can be read in the LICENSE file.