PHPackages                             perimeter/array-transformer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. perimeter/array-transformer

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

perimeter/array-transformer
===========================

Array Transformer

11.1kPHP

Since Apr 1Pushed 11y ago1 watchersCompare

[ Source](https://github.com/perimeter/array-transformer)[ Packagist](https://packagist.org/packages/perimeter/array-transformer)[ RSS](/packages/perimeter-array-transformer/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

ArrayTransformer
================

[](#arraytransformer)

Simple class for transforming a PHP array a myriad of ways

[![Build Status](https://camo.githubusercontent.com/658931fb8af90203e185a5becfe3c2a0be3c1bf5434665f3345898e7bfb0cda5/68747470733a2f2f7472617669732d63692e6f72672f706572696d657465722f61727261792d7472616e73666f726d65722e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/perimeter/array-transformer)

Installation
------------

[](#installation)

Use [composer](http://getcomposer.org) like everyone else

```
$ composer require perimeter/array-transformer:dev-develop
```

Usage
-----

[](#usage)

Create an array transformer with your data:

```
$data = [ 'one' => 'foo', 'two' => [ 'bar', 'baz' ] ];
$transformer = new Perimeter\ArrayTransformer\ArrayTransformer($data);
```

Now, there is no end to the fun you can have!

### Rename

[](#rename)

```
// $data = [ 'A' => 'foo' ]
$transformer->rename('A', 'RENAMED');
// [ 'RENAMED' => 'foo' ]

// $data = [ 'A' => [ 'bar', 'baz' ] ]
$transformer->rename('A/0', 'RENAMED');
// [ 'A' => [ 1 => 'baz' ], 'RENAMED' => 'bar' ]

// $data = [ 'A' => [[ 'B' => 1 ], [ 'B' => 2 ]] ]
$transformer->rename('A/?/B', 'A/?/C');
// [ 'A' => [[ 'C' => 1 ], [ 'C' => '2' ]] ]
```

### Remove

[](#remove)

```
// $data = [ 'A' => 'foo', 'B' => 'bar' ]
$transformer->remove('A');
//  [ 'B' => 'bar' ]

// $data = [ 'A' => [ 'bar', 'baz' ] ]
$transformer->remove('A/?:equals("bar")');
// [ 'A' => [ 'baz' ] ]

// $data = [ 'A' => [ 'B' => 1 ], 'C' => '2' ]
$transformer->remove('A:has(B=2)');
// [ 'C' => '2' ]
```

### Replace

[](#replace)

```
// $data = [ 'A' => 1 ]
$transformer->replace('A', [1=>2]);
//  [ 'A' => 2 ]

// $data = [ 'A' => 'abca' ]
$transformer->replace('A', ['a'=>'xxx']);
// [ 'A' => [ 'xxxbcxxx' ] ]
```

### Translate

[](#translate)

```
// $data = [ [ 'A' => 1 ], [ 'A' => 2 ], [ 'A' => 3 ] ]
$transformer->translate('A/?', [
  1 => 'one',
  2 => 'two',
  3 = >'three'
]);
//  [ [ 'A' => 'one' ], [ 'A' => 'two' ], [ 'A' => 'three' ] ]
```

### Reorder

[](#reorder)

```
// $data = [ 'A' => true, 'B' => false ]
$transformer->reorder('A', 'after', 'B');
//  [ 'B' => false, 'A' => true ]

// $data = [ 'A' => true, 'B' => false ]
$transformer->reorder('B', 'before', 'A');
//  [ 'B' => false, 'A' => true ]

// $data = [ 'A' => true, 'B' => false, 'C' => true ]
$transformer->reorder('C', 'first');
//  [ 'C' => true, 'A' => true, 'B' => false ]

// $data = [ 'A' => true, 'B' => false, 'C' => true ]
$transformer->reorder('A', 'last');
//  [ 'B' => false, 'C' => true, 'A' => true ]
```

### Modify

[](#modify)

```
// $data = [ 'A' => 'tEst', 'B' => 'UPPERCASE' ]
$transformer->modify('B', 'strtolower');
//  [ 'A' => 'tEst', 'B' => 'uppercase' ]

// $data = [ 'A' => 'boat', 'B' => [ 'car', 'track' ] ]
$transformer->modify('B', function ($var) { return 'race'.$var; });
//  [ 'A' => 'boat', 'B' => [ 'racecar', 'racetrack' ] ]
```

Syntax
------

[](#syntax)

This class uses the concept of a "path" to index into multi-dimentional arrays. The wild-card `?` is used to iterate over the entire subarray.

**Examples:**

```
A       -->   $array['A']
A/B     -->   $array['A']['B']
A/?/B   -->   foreach($array['A'] as $k => $v) $array['A'][$k]['B']

```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/a8713415b20b4be4cec8f8b22741e3cd05f76eee9e38de1de5bf32727349b7c5?d=identicon)[bshaffer](/maintainers/bshaffer)

---

Top Contributors

[![bshaffer](https://avatars.githubusercontent.com/u/103941?v=4)](https://github.com/bshaffer "bshaffer (5 commits)")

### Embed Badge

![Health badge](/badges/perimeter-array-transformer/health.svg)

```
[![Health](https://phpackages.com/badges/perimeter-array-transformer/health.svg)](https://phpackages.com/packages/perimeter-array-transformer)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
