thesis/exceptionally

Thesis Exceptionally

0.2.0 2026-03-25 20:04 UTC

Requires

• php: ^8.3

Requires (Dev)

• phpunit/phpunit: ^12.5.14

MIT

• kafkiansky
• Valentin Udaltsov
• Thesis Team

README

A tiny PHP library that converts errors to exceptions.

Installation

composer require thesis/exceptionally

Requires PHP 8.3+.

Usage

use function Thesis\exceptionally;

// Converts PHP errors to ErrorException
$content = exceptionally(static fn() => file_get_contents('/path/to/file'));

Many PHP functions trigger errors instead of throwing exceptions. This makes error handling inconsistent and cumbersome. exceptionally() wraps a callable and converts any triggered error into a native ErrorException.

Filtering by error level

By default, all error levels are caught. You can specify which levels to convert:

// Only convert notices
$result = exceptionally($callback, E_USER_NOTICE);

// Convert warnings and notices
$result = exceptionally($callback, E_USER_WARNING | E_USER_NOTICE);

License

MIT