📦 Класс Arr

Утилитный класс для работы с массивами. Поддерживает доступ по dot-ключам, проверку структуры, глубокую декодировку JSON, фильтрацию ключей и объединение массивов по ключу.

🔑 get(array $array, string $key, $default = null)

Получает значение из массива по ключу в dot-нотации.

📌 Пример:

$data = ['user' => ['name' => 'Alice']];
$name = Arr::get($data, 'user.name'); // 'Alice'

📝 set(array &$array, string $key, $value): void

Устанавливает значение в массив по ключу в dot-нотации.

📌 Пример:

$data = [];
Arr::set($data, 'user.email', 'test@example.com');
// $data = ['user' => ['email' => 'test@example.com']]

📋 isList(array $array): bool

Проверяет, является ли массив обычным списком (индексированным от 0).

📌 Пример:

Arr::isList(['a', 'b']); // true
Arr::isList(['a' => 1, 'b' => 2]); // false

📁 isAssoc(array $array): bool

Проверяет, является ли массив ассоциативным.

📌 Пример:

Arr::isAssoc(['a' => 1, 'b' => 2]); // true

🌲 depth(array $array): int

Возвращает максимальную глубину вложенности массива.

📌 Пример:

Arr::depth([1, [2, [3]]]); // 3

🧠 jsonDecode($data, $assoc = true, $depth = 512, $options = 0)

Глубоко декодирует JSON-строки, даже если они вложены в массивы.

📌 Пример:

$json = '{"user":"{\"name\":\"Alice\"}"}';
$result = Arr::jsonDecode($json);
// ['user' => ['name' => 'Alice']]

🚫 exceptKeys(array $array, array $keys): array

Удаляет из массива указанные ключи.

📌 Пример:

$data = ['name' => 'Alice', 'email' => 'a@example.com'];
$result = Arr::exceptKeys($data, ['email']);
// ['name' => 'Alice']

✅ onlyKeys(array $array, array $keys): array

Оставляет в массиве только указанные ключи.

📌 Пример:

$data = ['name' => 'Alice', 'email' => 'a@example.com'];
$result = Arr::onlyKeys($data, ['email']);
// ['email' => 'a@example.com']

🔗 mergeByKeyMatch(array $base, array $extra, string $key): array

Объединяет два массива по совпадению значения указанного ключа.

📌 Пример:

$base = [['id' => 1, 'name' => 'Alice'], ['id' => 2, 'name' => 'Bob']];
$extra = [['id' => 2, 'email' => 'bob@example.com']];
$result = Arr::mergeByKeyMatch($base, $extra, 'id');

/*
[
  ['id' => 1, 'name' => 'Alice'],
  ['id' => 2, 'name' => 'Bob', 'email' => 'bob@example.com']
]
*/