kasperhansen/dot-array-mapper

Mapping array data using dot notation.

1.1.0 2025-08-10 18:30 UTC

Requires

• php: >=8.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.84
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.2

MIT

• Kasper Hansen

• array
• mapper
• dot notation

README

Mapping array data using dot notation.

Installation

composer require kasperhansen/dot-array-mapper

Usage

use Kasperhansen\DotArrayMapper;

$mapper = new DotArrayMapper();

// Set the data to be mapped
$mapper
    ->setData([
        'user' => [
            'name' => 'John Doe',
            'email' => '[e-mail]',
            'address' => [
                'city' => 'New York',
            ],
        ],
    ])
    ->map([
        'name' => 'user.name',
        'email' => 'user.email',
        'city' => 'user.address.city',
    ])
    ->addFilter('name', fn($value) => strtoupper($value))
    ->addFilter('email', fn($value) => strtolower($value));

// Extract the mapped data
$mappedData = $mapper->extract();

// Output the mapped data
echo $mappedData['name']; // John Doe
echo $mappedData['email']; // [e-mail]
echo $mappedData['city']; // New York

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome!