Observium_CE/includes/polyfill.inc.php

<?php
/**
 * Observium
 *
 *   This file is part of Observium.
 *
 * @package    observium
 * @subpackage common
 * @copyright  (C) 2006-2013 Adam Armstrong, (C) 2013-2023 Observium Limited
 *
 */

// PHP (7.2) compat functions

if (PHP_VERSION_ID < 70200) {
    /**
     * @param $string
     * @param $encoding
     *
     * @return int|mixed
     */
    function mb_ord($string, $encoding = NULL)
    {
        if ($encoding && $encoding !== 'UTF-8') {
            $string = mb_convert_encoding($string, 'UTF-8', $encoding);
        }

        if (strlen($string) === 1) {
            return ord($string);
        }

        $code = ($string = unpack('C*', substr($string, 0, 4))) ? $string[1] : 0;
        if (0xF0 <= $code) {
            return (($code - 0xF0) << 18) + (($string[2] - 0x80) << 12) + (($string[3] - 0x80) << 6) + $string[4] - 0x80;
        }
        if (0xE0 <= $code) {
            return (($code - 0xE0) << 12) + (($string[2] - 0x80) << 6) + $string[3] - 0x80;
        }
        if (0xC0 <= $code) {
            return (($code - 0xC0) << 6) + $string[2] - 0x80;
        }

        return $code;
    }
}

// PHP (7.3) compat functions

if (PHP_VERSION_ID < 70300) {
    /**
     * Gets the first key of an array
     *
     * @param array $array
     *
     * @return mixed
     */
    function array_key_first($array)
    {
        if (!is_array($array) || empty($array)) {
            return NULL;
        }

        foreach ($array as $key => $unused) {
            return $key;
        }
        return NULL;
    }

    /* Use official polifyll
    function array_key_first($array) {
        return $array && is_array($array) ? array_keys($array)[0] : NULL;
    }
    */

    /**
     * Gets the last key of an array
     *
     * @param array $array
     *
     * @return mixed
     */
    function array_key_last($array)
    {
        if (!is_array($array) || empty($array)) {
            return NULL;
        }

        end($array);
        return key($array);
        //return $array && is_array($array) ? array_keys($array)[count($array) - 1] : NULL;
    }

    function is_countable($var)
    {
        return (is_array($var) || $var instanceof Countable);
    }
}

// PHP (8.0) compat functions

if (PHP_VERSION_ID < 80000) {
    // Note. We use better implementations str_contains_array() and str_icontains_array()
    function str_contains($haystack, $needle)
    {
        return '' === $needle || FALSE !== strpos($haystack, $needle);
    }

    function str_starts_with($haystack, $needle)
    {
        return 0 === strncmp($haystack, $needle, strlen($needle));
    }

    function str_ends_with($haystack, $needle)
    {
        if ('' === $needle || $needle === $haystack) {
            return TRUE;
        }

        if ('' === $haystack) {
            return FALSE;
        }

        $needle_len = strlen($needle);

        return $needle_len <= strlen($haystack) && 0 === substr_compare($haystack, $needle, -$needle_len);
    }

    function fdiv($dividend, $divisor)
    {
        return @($dividend / $divisor);
    }
}

// PHP (8.1) compat functions

if (PHP_VERSION_ID < 80100) {
    function array_is_list(array $array)
    {
        if ([] === $array || $array === array_values($array)) {
            return TRUE;
        }

        $next_key = -1;

        foreach ($array as $k => $v) {
            if ($k !== ++$next_key) {
                return FALSE;
            }
        }

        return TRUE;
    }
}

// PHP (8.3) compat functions

if (PHP_VERSION_ID < 80300) {

    function json_validate(string $json, int $depth = 512, int $flags = 0)
    {
        if (0 !== $flags && defined('JSON_INVALID_UTF8_IGNORE') && JSON_INVALID_UTF8_IGNORE !== $flags) {
            throw new \ValueError('json_validate(): Argument #3 ($flags) must be a valid flag (allowed flags: JSON_INVALID_UTF8_IGNORE)');
        }

        if ($depth <= 0) {
            throw new \ValueError('json_validate(): Argument #2 ($depth) must be greater than 0');
        }

        // see https://www.php.net/manual/en/function.json-decode.php
        if ($depth > 2147483647) {
            throw new \ValueError(sprintf('json_validate(): Argument #2 ($depth) must be less than %d', 2147483647));
        }

        json_decode($json, NULL, $depth, $flags);

        return JSON_ERROR_NONE === json_last_error();
    }
}

// EOF