mpyw/exceper

Provides temporary error handler automatically using set_error_handler() and restore_error_handler().

Exceper

Provides temporary error handler automatically using [set_error_handler()] and [restore_error_handler()]., _(*1)

Installing

composer require mpyw/exceper

Quick Example

<?php

require __DIR__ . '/vendor/autoload.php';

use Mpyw\Exceper\Convert;

try {

    // We pick errors triggered by fopen() or fgets().
    // They are converted into \RuntimeException.
    Convert::toRuntimeException(function () {
        $fp = fopen('http://example.com', 'rb');
        while (false !== $line = fgets($fp)) {
            echo $line;
        }
    });

} catch (\RuntimeException $e) {

    // Do something here

}

// Error handler is already automatically restored.

API

Mpyw\Exceper\Convert::to()
Mpyw\Exceper\Convert::to{$class}()

Capture errors to convert into an instance of the specified class., _(*2)

• Error handlers are automatically restored.
• ->getFile() and ->getLine() returns correct locations like ErrorException does.

static Mpyw\Exceper\Convert::to(string $class, callable $callback, int $types = E_ALL | E_STRICT): mixed
static Mpyw\Exceper\Convert::to{$class}(callable $callback, int $types = E_ALL | E_STRICT): mixed
static Mpyw\Exceper\Convert::to(string $class, int $code, callable $callback, int $types = E_ALL | E_STRICT): mixed
static Mpyw\Exceper\Convert::to{$class}(int $code, callable $callback, int $types = E_ALL | E_STRICT): mixed

Arguments

• (string) __$class__
  Conversion target class name which is an instance of \Exception or \Throwable. Please note that case-sensitivity of class name depends on the implementation of your autoloaders, which can cause an unexpected behavior if the target class is not loaded.
• (int) __$code__
  Error code passed to the constructor as the second argument. Default to 0.
• (callable) __$callback__
  Callback function to be executed. This parameter SHOULD be used as \Closure because arguments cannot be specified.
• (int) __$types__
  Bit mask of target error severities.

Return Value

(mixed)
Propagates upcoming value from $callback()., _(*3)

Exception

Converted errors., _(*4)

Mpyw\Exceper\Convert::silent()

Capture errors but never throw anything., _(*5)

static Mpyw\Exceper\Convert::silent(callable $callback, int $types = E_ALL | E_STRICT, bool $captureExceptions = true): mixed

Arguments

• (callable) __$callback__
  Callback function to be executed. This parameter SHOULD be a \Closure because arguments cannot be specified.
• (int) __$types__
  Bit mask of target error severities.
• (bool) __$captureExceptions__
  Capture exceptions that were directly thrown; not originated in set_error_handler().

Return Value

(mixed)
Propagates upcoming value from $callback(). Returns null if something thrown., _(*6)