Exceptions

Package exceptions live in RoundlyConsulting\Options\Exceptions and extend the abstract OptionException, so one catch handles all of them. The one failure that isn’t an OptionException is a value an option’s rules() refuse — that throws Laravel’s ValidationException (see Validation), so catch it as well:

use Illuminate\Validation\ValidationException;
use RoundlyConsulting\Options\Exceptions\OptionException;
use RoundlyConsulting\Options\Exceptions\UnauthorizedOption;

try {
    Options::set(MaintenanceModeOption::class, true);
} catch (UnauthorizedOption $e) {
    abort(403);
} catch (ValidationException $e) {
    // the value failed the option's rules(); $e->errors()['value']
} catch (OptionException $e) {
    report($e); // any other options error
}

From the framework

• Illuminate\Validation\ValidationException — a value fails the option’s rules().
• Illuminate\Contracts\Encryption\DecryptException — encrypted ciphertext was tampered with or the APP_KEY changed.
• RoundlyConsulting\PackageToolkit\Exceptions\InvalidConfigurationException — a config value is invalid: options.model isn’t Option or a subclass of it, an unknown key_type, a switch that isn’t a boolean, a cache.ttl that isn’t a whole number of at least 1, or a cache.store, cache.prefix or cache.tag that isn’t a string. The message names the key.