shimmie2/core/stdlib_ex.php

<?php

/**
 * @template T
 * @param T|false $x
 * @return T
 */
function false_throws(mixed $x, ?callable $errorgen = null): mixed
{
    if ($x === false) {
        $msg = "Unexpected false";
        if ($errorgen) {
            $msg = $errorgen();
        }
        throw new \Exception($msg);
    }
    return $x;
}

# https://github.com/thecodingmachine/safe/pull/428
function inet_pton_ex(string $ip_address): string
{
    return false_throws(inet_pton($ip_address));
}

function dir_ex(string $directory): \Directory
{
    return false_throws(dir($directory));
}

function filter_var_ex(mixed $variable, int $filter = FILTER_DEFAULT, mixed $options = null): mixed
{
    return false_throws(filter_var($variable, $filter, $options));
}

function preg_replace_ex(string $pattern, string $replacement, string $subject, int $limit = -1, ?int &$count = null): string
{
    $res = preg_replace($pattern, $replacement, $subject, $limit, $count);
    if (is_null($res)) {
        throw new \Exception("preg_replace failed");
    }
    return $res;
}