CHORE: Improved array handling

Author: phphleb

HlebBootstrap.php

@@ -109,7 +109,7 @@ public function __construct(?string $publicPath = null, array $config = [], ?Log
 
         // The current version of the framework.
         // Текущая версия фреймворка.
-        \defined('HLEB_CORE_VERSION') or \define('HLEB_CORE_VERSION', '2.1.20');
+        \defined('HLEB_CORE_VERSION') or \define('HLEB_CORE_VERSION', '2.1.21');
 
         $this->logger = $logger;
 
@@ -1010,7 +1010,7 @@ protected function switchInit(array &$config): void
                 $uri = \parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH);
                 \http_response_code(200);
                 \header('Content-Type: text/plain');
-                \header('Connection: close');
+                // \header('Connection: close');
                 if (\str_starts_with($uri, '/user/')) {
                     $output = \substr($uri, 6);
                 }

Init/Functions.php

@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+namespace Hleb\Init;
+
 use Hleb\Constructor\Data\SystemSettings;
 use Hleb\Static\Debug;
 use Hleb\Static\Path;
@@ -21,7 +23,7 @@ public function create(): bool
             return false;
         }
         if ($files = SystemSettings::getValue('system', 'custom.function.files')) {
-            foreach($files as $file) {
+            foreach ($files as $file) {
                 require Path::get('global') . DIRECTORY_SEPARATOR . \ltrim($file, '\\/');
             }
         }
@@ -288,6 +290,40 @@ function array_all(array $array, callable $callback): bool
             }
         }
 
+        if (!function_exists('array_first')) {
+            /**
+             * Returns the first value of the array without the pointer offset.
+             * Similar to array_first() in PHP 8.5
+             *
+             * Возвращает первое значение массива без смещения указателя.
+             * Аналогично array_first() в PHP 8.5
+             */
+            function array_first(array $array): mixed
+            {
+                if (empty($array)) {
+                    return null;
+                }
+                return $array[\array_key_first($array)];
+            }
+        }
+
+        if (!function_exists('array_last')) {
+            /**
+             * Returns the last value of the array without the pointer offset.
+             * Similar to array_last() in PHP 8.5
+             *
+             * Возвращает последнее значение массива без смещения указателя.
+             * Аналогично array_last() в PHP 8.5
+             */
+            function array_last()
+            {
+                if (empty($array)) {
+                    return null;
+                }
+                return $array[\array_key_last($array)];
+            }
+        }
+
         if (!function_exists('array_any')) {
             /**
              * Checks whether at least one array element matches a condition.
@@ -310,4 +346,5 @@ function array_any(array $array, callable $callback): bool
 
         return true;
     }
+
 }

Reference/ArrInterface.php

@@ -190,4 +190,31 @@ public function set(array &$array, string|int|null $key, mixed $value): array;
      * ```
      */
     public function expand(iterable $array): array;
+
+    /**
+     * Returns a new array that checks the original for all elements with the keys listed in $keys.
+     *
+     * Возвращает новый массив, исключая из исходного все элементы с ключами, перечисленными в $keys.
+     */
+    public function except(array $array, array|string $keys): array;
+
+    /**
+     * Returns an array that contains only the matching values from $values.
+     *
+     * Возвращает массив, в котором оставлены только совпавшие значения из $values.
+     *
+     * @param bool $strict - strict comparison when searching for matches.
+     *                      - строгое сравнение при поиске совпадений.
+     */
+    public function onlyValues(array $array, array $values, bool $strict = false): array;
+
+    /**
+     * Returns an array excluding all values from $values.
+     *
+     * Возвращает массив, в котором исключены все значения из $values.
+     *
+     * @param bool $strict - strict comparison when searching for matches.
+     *                     - строгое сравнение при поиске совпадений.
+     */
+    public function exceptValues(array $array, array $values, bool $strict = false): array;
 }

Reference/ArrReference.php

@@ -102,4 +102,25 @@ public function expand(iterable $array): array
     {
         return ArrayHelper::expand($array);
     }
+
+    /** @inheritDoc */
+    #[\Override]
+    public function except(array $array, array|string $keys): array
+    {
+        return ArrayHelper::except($array, $keys);
+    }
+
+    /** @inheritDoc */
+    #[\Override]
+    public function onlyValues(array $array, array $values, bool $strict = false): array
+    {
+        return ArrayHelper::onlyValues($array, $values, $strict);
+    }
+
+    /** @inheritDoc */
+    #[\Override]
+    public function exceptValues(array $array, array $values, bool $strict = false): array
+    {
+        return ArrayHelper::exceptValues($array, $values, $strict);
+    }
 }

Static/Arr.php

@@ -316,6 +316,54 @@ public static function expand(iterable $array): array
         return BaseContainer::instance()->get(ArrInterface::class)->expand($array);
     }
 
+    /**
+     * Returns a new array that checks the original for all elements with the keys listed in $keys.
+     *
+     * Возвращает новый массив, исключая из исходного все элементы с ключами, перечисленными в $keys.
+     */
+    public static function except(array $array, array|string $keys): array
+    {
+        if (self::$replace) {
+            return self::$replace->except($array, $keys);
+        }
+
+        return BaseContainer::instance()->get(ArrInterface::class)->except($array, $keys);
+    }
+
+    /**
+     * Returns an array that contains only the matching values from $values.
+     *
+     * Возвращает массив, в котором оставлены только совпавшие значения из $values.
+     *
+     * @param bool $strict - strict comparison when searching for matches.
+     *                      - строгое сравнение при поиске совпадений.
+     */
+    public static function onlyValues(array $array, array $values, bool $strict = false): array
+    {
+        if (self::$replace) {
+            return self::$replace->onlyValues($array, $values, $strict);
+        }
+
+        return BaseContainer::instance()->get(ArrInterface::class)->onlyValues($array, $values, $strict);
+    }
+
+    /**
+     * Returns an array excluding all values from $values.
+     *
+     * Возвращает массив, в котором исключены все значения из $values.
+     *
+     * @param bool $strict - strict comparison when searching for matches.
+     *                     - строгое сравнение при поиске совпадений.
+     */
+    public static function exceptValues(array $array, array $values, bool $strict = false): array
+    {
+        if (self::$replace) {
+            return self::$replace->exceptValues($array, $values, $strict);
+        }
+
+        return BaseContainer::instance()->get(ArrInterface::class)->exceptValues($array, $values, $strict);
+    }
+
     /**
      * @internal
      *