README

ArrayKit is a modern PHP 8.2+ library for elegant, high-performance array manipulation, dot notation utilities, dynamic configuration, hookable collections, and more. From shallow single arrays to deeply nested data structures — ArrayKit provides a fluent, reliable toolkit for real-world PHP projects.

???? Features at a Glance

✅ Single-Dimensional Helpers ✅ Multi-Dimensional Helpers ✅ Dot Notation Get/Set/Flatten ✅ Dynamic Config with Hooks ✅ Collection & Hooked Collection ✅ Traits for DTO & Hooking ✅ Pipeline for Collection Ops ✅ Global Helpers (functions.php)

???? Modules

➤ Array Helpers

➤ Config System

➤ Collections

➤ Traits

➤ Global Helpers

✅ Requirements

• PHP 8.2 or higher

⚡ Installation

composer require infocyph/arraykit

???? Quick Examples

???? Single-Dimensional Helpers

use Infocyph\ArrayKit\Array\ArraySingle; $list = [1, 2, 3, 2]; // Is it a list? $isList = ArraySingle::isList($list); // true // Duplicates $dupes = ArraySingle::duplicates($list); // [2] // Pagination $page = ArraySingle::paginate($list, page:1, perPage:2); // [1, 2]

???? Multi-Dimensional Helpers

use Infocyph\ArrayKit\Array\ArrayMulti; $data = [ [1, 2], [3, [4, 5]] ]; // Flatten to one level $flat = ArrayMulti::flatten($data); // [1, 2, 3, 4, 5] // Collapse one level $collapsed = ArrayMulti::collapse($data); // [1, 2, 3, [4, 5]] // Nesting depth $depth = ArrayMulti::depth($data); // 3 // Recursive sort $sorted = ArrayMulti::sortRecursive($data);

???? Dot Notation

use Infocyph\ArrayKit\Array\DotNotation; $user = [ 'profile' => ['name' => 'Alice'] ]; // Get value $name = DotNotation::get($user, 'profile.name'); // Alice // Set value DotNotation::set($user, 'profile.email', 'alice@example.com'); // Flatten $flat = DotNotation::flatten($user); // [ 'profile.name' => 'Alice', 'profile.email' => 'alice@example.com' ]

???? Dynamic Config with Hooks

use Infocyph\ArrayKit\Config\DynamicConfig; $config = new DynamicConfig(); // Load from file $config->loadFile(__DIR__.'/config.php'); // Hook: auto-hash password when set $config->onSet('auth.password', fn($v) => password_hash($v, PASSWORD_BCRYPT)); // Hook: decrypt when getting 'secure.key' $config->onGet('secure.key', fn($v) => decrypt($v)); // Use it $config->set('auth.password', 'secret123'); $hashed = $config->get('auth.password');

???? Hooked Collection

use Infocyph\ArrayKit\Collection\HookedCollection; $collection = new HookedCollection(['name' => 'alice']); // Hook on-get: uppercase $collection->onGet('name', fn($v) => strtoupper($v)); // Hook on-set: prefix $collection->onSet('role', fn($v) => "Role: $v"); echo $collection['name']; // ALICE $collection['role'] = 'admin'; echo $collection['role']; // Role: admin

???? DTO Trait Example

use Infocyph\ArrayKit\traits\DTOTrait; class UserDTO { use DTOTrait; public string $name; public string $email; } $user = new UserDTO(); $user->fromArray(['name' => 'Alice', 'email' => 'alice@example.com']); $array = $user->toArray();

???? Support

Have a bug or feature idea? Please open an issue.

???? License

Licensed under the MIT License — use it freely for personal or commercial projects. See LICENSE for details.