aimeos/map
Map
This PHP data collection library is a functional data wrapper and array manipulation framework. It converts arrays, JSON strings, and iterables into chainable collection objects designed for advanced filtering, sorting, and transformation.
The library is distinguished by its ability to dynamically extend functionality through the registration of custom methods via closures. It also provides specialized capabilities for hierarchical data modeling, allowing flat datasets with parent-child identifiers to be reconstructed into nested tree structures.
The toolkit covers a broad surface of data manipulation, including statistical aggregation, bulk string transformations, and element type casting. It provides utilities for data structure transposition, such as flipping keys and values, as well as mechanisms for exporting collections as plain arrays, JSON strings, or HTTP query strings.
Features
- Fluent Collection Pipelines - Provides a fluent, chainable API for filtering, sorting, transforming, and aggregating PHP arrays.
- Transposition Utilities - Flips keys and values, flattens nested arrays, or expands key paths into multi-dimensional structures.
- Collection Element Transformations - Applies callbacks to map, reduce, flatten, group, or restructure collections into new forms.
- Multi-Source Constructions - Creates collections from arrays, JSON strings, iterables, or repeated closure calls.
- Column Value Aggregations - Computes sum, average, min, max, and frequency counts on collection values.
- Conditional Data Filters - Applies callbacks or regular expressions to filter collection elements based on conditions.
- Value and Callback Sorters - Orders items by values, keys, or custom callbacks with ascending/descending and key preservation.
- Fluent Query APIs - Ships a fluent, chainable API for building and transforming data collections through method chaining.
- Multi-Source Collection Factories - Creates collections from arrays, JSON strings, iterables, and repeated closure calls.
- Collection Content Testers - Checks if elements exist, match a condition, or are of a specific type such as string, numeric, or object.
- Collection Element Accessors - Retrieves single or multiple elements using keys, numerical positions, or callbacks, with optional type casting.
- Collection Element Inserters - Inserts new items at specific positions, appends to the end, or merges collections with or without overwriting existing keys.
- Collection Element Removers - Deletes elements by key, value, or position and optionally returns the removed item.
- Collection Factories - Builds a new map from an array, JSON string, string split by delimiter, or repeated closure calls.
- Collection Serialization - Converts collections to plain arrays, JSON strings, or HTTP query strings for output.
- PHP Data Collection Libraries - Provides a functional data wrapper for arrays, JSON, and iterables with chainable operations.
- Runtime Closure Bindings - Provides a mechanism to extend collection objects with user-defined closures as built-in methods.
- Custom Method Registration - Registers user-defined closures as built-in methods on collection objects at runtime.
- Hierarchical Reconstruction - Reconstructs flat parent-child datasets into nested tree structures for hierarchical data.
- Element Filtering - Filters elements by callbacks, regular expressions, key comparisons, or value conditions.
- Collection Partitioning & Grouping - Provides chainable methods for splitting collections into chunks and grouping by keys.
- Custom Callback Sorters - Ships a fluent sorting API supporting custom callbacks, key-based, and value-based ordering.
- Statistical Aggregators - Computes summary statistics such as sum, average, min, max, and frequency counts on collection values.
- Head and Tail Slicers - Provides methods to extract subsets like first, last, and slice from collections.
- Array Flattening Utilities - Reduces multi-dimensional arrays to a single level or expands key paths into nested structures.
- Lazy Evaluation - Defers computation until terminal operations are called, enabling efficient chaining of transformations.
- Collection Condition Testers - Provides boolean checks for element existence, type constraints, and pattern matching.
