Final Class Yiisoft\Arrays\ArrayHelper

                public static function addValue(array &$array, array|float|int|string|null $key, mixed $value): void
{
    if ($key === null) {
        $array[] = $value;
        return;
    }
    $keys = is_array($key) ? $key : [$key];
    while (count($keys) > 0) {
        $k = self::normalizeArrayKey(array_shift($keys));
        if (!array_key_exists($k, $array)) {
            $array[$k] = [];
        } elseif (!is_array($array[$k])) {
            $array[$k] = [$array[$k]];
        }
        $array = &$array[$k];
        /** @var array $array */
    }
    $array[] = $value;
}

            

                public static function addValueByPath(
    array &$array,
    array|float|int|string|null $path,
    mixed $value,
    string $delimiter = '.'
): void {
    self::addValue($array, $path === null ? null : self::parseMixedPath($path, $delimiter), $value);
}

            

                public static function filter(array $array, array $filters): array
{
    $result = [];
    $excludeFilters = [];
    foreach ($filters as $filter) {
        if ($filter[0] === '!') {
            $excludeFilters[] = substr($filter, 1);
            continue;
        }
        $nodeValue = $array; // Set $array as root node.
        $keys = explode('.', $filter);
        foreach ($keys as $key) {
            if (!is_array($nodeValue) || !array_key_exists($key, $nodeValue)) {
                continue 2; // Jump to the next filter.
            }
            $nodeValue = $nodeValue[$key];
        }
        // We've found a value now let's insert it.
        $resultNode = &$result;
        foreach ($keys as $key) {
            if (!array_key_exists($key, $resultNode)) {
                $resultNode[$key] = [];
            }
            /** @psalm-suppress MixedAssignment */
            $resultNode = &$resultNode[$key];
            /** @var array $resultNode */
        }
        /** @var array */
        $resultNode = $nodeValue;
    }
    /**
     * @psalm-suppress UnnecessaryVarAnnotation
     *
     * @var array $result
     */
    foreach ($excludeFilters as $filter) {
        $excludeNode = &$result;
        $keys = explode('.', $filter);
        $numNestedKeys = count($keys) - 1;
        foreach ($keys as $i => $key) {
            if (!is_array($excludeNode) || !array_key_exists($key, $excludeNode)) {
                continue 2; // Jump to the next filter.
            }
            if ($i < $numNestedKeys) {
                /** @psalm-suppress MixedAssignment */
                $excludeNode = &$excludeNode[$key];
            } else {
                unset($excludeNode[$key]);
                break;
            }
        }
    }
    /** @var array $result */
    return $result;
}

            

                public static function getColumn(iterable $array, Closure|string $name, bool $keepKeys = true): array
{
    $result = [];
    if ($keepKeys) {
        foreach ($array as $k => $element) {
            $result[$k] = self::getValue($element, $name);
        }
    } else {
        foreach ($array as $element) {
            $result[] = self::getValue($element, $name);
        }
    }
    return $result;
}

            

                public static function getObjectVars(object $object): array
{
    return get_object_vars($object);
}

            

                public static function getValue(
    array|object $array,
    array|Closure|float|int|string $key,
    mixed $default = null
): mixed {
    if ($key instanceof Closure) {
        return $key($array, $default);
    }
    if (is_array($key)) {
        if (empty($key)) {
            return $default;
        }
        $lastKey = array_pop($key);
        foreach ($key as $keyPart) {
            $array = self::getRootValue($array, $keyPart, null);
            if (!is_array($array) && !is_object($array)) {
                return $default;
            }
        }
        return self::getRootValue($array, $lastKey, $default);
    }
    return self::getRootValue($array, $key, $default);
}

            

                public static function getValueByPath(
    array|object $array,
    array|Closure|float|int|string $path,
    mixed $default = null,
    string $delimiter = '.'
): mixed {
    return self::getValue(
        $array,
        $path instanceof Closure ? $path : self::parseMixedPath($path, $delimiter),
        $default
    );
}

            

                public static function group(iterable $array, array|string $groups): array
{
    /** @psalm-var array<non-empty-list<T>> */
    return self::index($array, null, $groups);
}

            

                public static function htmlDecode(iterable $data, bool $valuesOnly = true): array
{
    $decoded = [];
    foreach ($data as $key => $value) {
        if (!is_int($key)) {
            $key = (string)$key;
        }
        if (!$valuesOnly && is_string($key)) {
            $key = htmlspecialchars_decode($key, ENT_QUOTES);
        }
        if (is_string($value)) {
            $decoded[$key] = htmlspecialchars_decode($value, ENT_QUOTES);
        } elseif (is_array($value)) {
            $decoded[$key] = self::htmlDecode($value);
        } else {
            $decoded[$key] = $value;
        }
    }
    return $decoded;
}

            

                public static function htmlEncode(iterable $data, bool $valuesOnly = true, ?string $encoding = null): array
{
    if (!is_array($data)) {
        $data = iterator_to_array($data);
    }
    $encoding ??= ini_get('default_charset') ?: 'UTF-8';
    $flags = ENT_QUOTES | ENT_SUBSTITUTE;
    return $valuesOnly
        ? self::htmlEncodeValues($data, $flags, $encoding)
        : self::htmlEncodeKeysAndValues($data, $flags, $encoding);
}

            

                public static function index(
    iterable $array,
    Closure|string|null $key,
    array|string|null $groups = []
): array {
    $result = [];
    $groups = (array)$groups;
    /** @var mixed $element */
    foreach ($array as $element) {
        if (!is_array($element) && !is_object($element)) {
            throw new InvalidArgumentException(
                'index() can not get value from ' . gettype($element) .
                '. The $array should be either multidimensional array or an array of objects.'
            );
        }
        $lastArray = &$result;
        foreach ($groups as $group) {
            $value = self::normalizeArrayKey(
                self::getValue($element, $group)
            );
            if (!array_key_exists($value, $lastArray)) {
                $lastArray[$value] = [];
            }
            /** @psalm-suppress MixedAssignment */
            $lastArray = &$lastArray[$value];
            /** @var array $lastArray */
        }
        if ($key === null) {
            if (!empty($groups)) {
                $lastArray[] = $element;
            }
        } else {
            $value = self::getValue($element, $key);
            if ($value !== null) {
                $lastArray[self::normalizeArrayKey($value)] = $element;
            }
        }
        unset($lastArray);
    }
    return $result;
}

            

                public static function isAssociative(array $array, bool $allStrings = true): bool
{
    if ($array === []) {
        return false;
    }
    if ($allStrings) {
        foreach ($array as $key => $_value) {
            if (!is_string($key)) {
                return false;
            }
        }
        return true;
    }
    foreach ($array as $key => $_value) {
        if (is_string($key)) {
            return true;
        }
    }
    return false;
}

            

                public static function isIn(mixed $needle, iterable $haystack, bool $strict = false): bool
{
    if (is_array($haystack)) {
        return in_array($needle, $haystack, $strict);
    }
    foreach ($haystack as $value) {
        if ($needle == $value && (!$strict || $needle === $value)) {
            return true;
        }
    }
    return false;
}

            

                public static function isIndexed(array $array, bool $consecutive = false): bool
{
    if ($array === []) {
        return true;
    }
    if ($consecutive) {
        return array_is_list($array);
    }
    foreach ($array as $key => $_value) {
        if (!is_int($key)) {
            return false;
        }
    }
    return true;
}

            

                public static function isSubset(iterable $needles, iterable $haystack, bool $strict = false): bool
{
    foreach ($needles as $needle) {
        if (!self::isIn($needle, $haystack, $strict)) {
            return false;
        }
    }
    return true;
}

            

                public static function keyExists(array $array, array|float|int|string $key, bool $caseSensitive = true): bool
{
    if (is_array($key)) {
        if (empty($key)) {
            return false;
        }
        if (count($key) === 1) {
            return self::rootKeyExists($array, end($key), $caseSensitive);
        }
        /** @psalm-var non-empty-array<array-key,float|int|string> $key */
        foreach (self::getExistsKeys($array, array_shift($key), $caseSensitive) as $existKey) {
            $array = self::getRootValue($array, $existKey, null);
            if (is_array($array) && self::keyExists($array, $key, $caseSensitive)) {
                return true;
            }
        }
        return false;
    }
    return self::rootKeyExists($array, $key, $caseSensitive);
}

            

                public static function map(
    iterable $array,
    Closure|string $from,
    Closure|string $to,
    Closure|string|null $group = null
): array {
    if ($group === null) {
        if ($from instanceof Closure || $to instanceof Closure || !is_array($array)) {
            $result = [];
            foreach ($array as $element) {
                $key = (string)self::getValue($element, $from);
                $result[$key] = self::getValue($element, $to);
            }
            return $result;
        }
        return array_column($array, $to, $from);
    }
    $result = [];
    foreach ($array as $element) {
        $groupKey = (string)self::getValue($element, $group);
        $key = (string)self::getValue($element, $from);
        $result[$groupKey][$key] = self::getValue($element, $to);
    }
    return $result;
}

            

                public static function merge(...$arrays): array
{
    return self::doMerge($arrays, null);
}

            

                public static function parametrizedMerge(array $arrays, ?int $depth): array
{
    return self::doMerge($arrays, $depth);
}

            

                public static function pathExists(
    array $array,
    array|float|int|string $path,
    bool $caseSensitive = true,
    string $delimiter = '.'
): bool {
    return self::keyExists($array, self::parseMixedPath($path, $delimiter), $caseSensitive);
}

            

                public static function remove(array &$array, array|float|int|string $key, mixed $default = null): mixed
{
    $keys = is_array($key) ? $key : [$key];
    while (count($keys) > 1) {
        $key = self::normalizeArrayKey(array_shift($keys));
        if (!isset($array[$key]) || !is_array($array[$key])) {
            return $default;
        }
        $array = &$array[$key];
    }
    $key = self::normalizeArrayKey(array_shift($keys));
    if (array_key_exists($key, $array)) {
        $value = $array[$key];
        unset($array[$key]);
        return $value;
    }
    return $default;
}

            

                public static function removeByPath(
    array &$array,
    array|float|int|string $path,
    mixed $default = null,
    string $delimiter = '.'
): mixed {
    return self::remove($array, self::parseMixedPath($path, $delimiter), $default);
}

            

                public static function removeValue(array &$array, mixed $value): array
{
    $result = [];
    foreach ($array as $key => $val) {
        if ($val === $value) {
            $result[$key] = $val;
            unset($array[$key]);
        }
    }
    return $result;
}

            

                public static function renameKey(array $array, int|string $from, int|string $to): array
{
    if (!array_key_exists($from, $array)) {
        return $array;
    }
    $keys = array_keys($array);
    $index = array_search($from, $keys);
    $keys[$index] = $to;
    return array_combine($keys, $array);
}

            

                public static function setValue(array &$array, array|float|int|string|null $key, mixed $value): void
{
    if ($key === null) {
        $array = $value;
        return;
    }
    $keys = is_array($key) ? $key : [$key];
    while (count($keys) > 1) {
        $k = self::normalizeArrayKey(array_shift($keys));
        if (!isset($array[$k])) {
            $array[$k] = [];
        }
        if (!is_array($array[$k])) {
            $array[$k] = [$array[$k]];
        }
        $array = &$array[$k];
        /** @var array $array */
    }
    $array[self::normalizeArrayKey(array_shift($keys))] = $value;
}

            

                public static function setValueByPath(
    array &$array,
    array|float|int|string|null $path,
    mixed $value,
    string $delimiter = '.'
): void {
    self::setValue($array, $path === null ? null : self::parseMixedPath($path, $delimiter), $value);
}

            

                public static function toArray(mixed $object, array $properties = [], bool $recursive = true): array
{
    if (is_array($object)) {
        if ($recursive) {
            foreach ($object as $key => $value) {
                if (is_array($value) || is_object($value)) {
                    $object[$key] = self::toArray($value, $properties);
                }
            }
        }
        return $object;
    }
    if (is_object($object)) {
        if (!empty($properties)) {
            $className = $object::class;
            if (!empty($properties[$className])) {
                $result = [];
                /**
                 * @var int|string $key
                 * @var string $name
                 */
                foreach ($properties[$className] as $key => $name) {
                    if (is_int($key)) {
                        $result[$name] = $object->$name;
                    } else {
                        $result[$key] = self::getValue($object, $name);
                    }
                }
                return $recursive ? self::toArray($result, $properties) : $result;
            }
        }
        if ($object instanceof ArrayableInterface) {
            $result = $object->toArray([], [], $recursive);
        } else {
            $result = [];
            /**
             * @var string $key
             */
            foreach ($object as $key => $value) {
                $result[$key] = $value;
            }
        }
        return $recursive ? self::toArray($result, $properties) : $result;
    }
    return [$object];
}