Commit version 24.12.13800

2025-01-06 17:35:06 -05:00
parent b7f6a79c2c
commit 55d9218816
6133 changed files with 4239740 additions and 1374287 deletions
--- a/includes/polyfill.inc.php
+++ b/includes/polyfill.inc.php
@ -0,0 +1,173 @@
+<?php
+/**
+ * Observium
+ *
+ *   This file is part of Observium.
+ *
+ * @package    observium
+ * @subpackage common
+ * @copyright  (C) Adam Armstrong
+ *
+ */
+
+// 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;
+        }
+
+        return array_keys($array)[0];
+    }
+
+    /**
+     * 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();
+    }
+}
+
+// PHP (8.4) compat functions
+
+if (PHP_VERSION_ID < 80400) {
+
+    function array_find(array $array, callable $callback) {
+        foreach ($array as $key => $value) {
+            if ($callback($value, $key)) {
+                return $value;
+            }
+        }
+
+        return NULL;
+    }
+
+    function array_find_key(array $array, callable $callback) {
+        foreach ($array as $key => $value) {
+            if ($callback($value, $key)) {
+                return $key;
+            }
+        }
+
+        return NULL;
+    }
+
+    function array_any(array $array, callable $callback) {
+        foreach ($array as $key => $value) {
+            if ($callback($value, $key)) {
+                return TRUE;
+            }
+        }
+
+        return FALSE;
+    }
+
+    function array_all(array $array, callable $callback) {
+        foreach ($array as $key => $value) {
+            if (!$callback($value, $key)) {
+                return FALSE;
+            }
+        }
+
+        return TRUE;
+    }
+}
+
+// EOF