thesis / exceptionally
Thesis Exceptionally
Fund package maintenance!
0.2.0
2026-03-25 20:04 UTC
Requires
- php: ^8.3
Requires (Dev)
- phpunit/phpunit: ^12.5.14
This package is auto-updated.
Last update: 2026-03-25 20:12:20 UTC
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