PHPackages                             andydune/array-container - 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 & Helpers](/categories/utility)
4. /
5. andydune/array-container

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

andydune/array-container
========================

It profitable for better accessibility to values. It supports any filters and mutators.

v1.19.1(6y ago)05282MITPHPPHP >=7.1CI failing

Since Mar 22Pushed 5y ago1 watchersCompare

[ Source](https://github.com/AndyDune/ArrayContainer)[ Packagist](https://packagist.org/packages/andydune/array-container)[ Docs](https://github.com/AndyDune/ArrayContainer)[ RSS](/packages/andydune-array-container/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (1)Versions (26)Used By (2)

ArrayContainer
==============

[](#arraycontainer)

[![Build Status](https://camo.githubusercontent.com/9ec3587ffceea9ddd322a1a43bf440c41c5873db0222cadb5ead08188ee8f330/68747470733a2f2f7472617669732d63692e6f72672f416e647944756e652f4172726179436f6e7461696e65722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/AndyDune/ArrayContainer)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/aa931a6ca723f375b9407f87c5d366d2f2aa36576a9581efe4585745e5f933a9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e647964756e652f61727261792d636f6e7461696e65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andydune/array-container)[![Total Downloads](https://camo.githubusercontent.com/4e6ec528074cd71f176b543bc3b03796b78df6f7950c8f9c660216a68a812f2a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e647964756e652f61727261792d636f6e7461696e65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andydune/array-container)

It offers convenient interface for encapsulated array. Implements strategy template for any number of filters.

Requirements
------------

[](#requirements)

- PHP version >= 7.1
- Sting "It's probably me" inside your headphones.

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

[](#installation)

Installation using composer:

```
composer require andydune/array-container

```

Or if composer was not installed globally:

```
php composer.phar require andydune/array-container

```

Or edit your `composer.json`:

```
"require" : {
     "andydune/array-container": "^1"
}

```

And execute command:

```
php composer.phar update

```

Simple access to array
----------------------

[](#simple-access-to-array)

You do not need to worry about existence any key.

```
use AndyDune\ArrayContainer\ArrayContainer;

$aray = new ArrayContainer(['pipe' => 'handemade', 'pipes_type' => ['lovat', 'canadian']]);
$array['pipe'] // value is 'handemade'
$array['tobacco'] // value is null
$array->getNested('pipes_type.0')  // value is 'lovat'
$array->getNested('pipes_type:0', null, ':')  // value is 'lovat'
$array->getNested('some.some', 'NO')  // value is 'NO'

// Set default value
$array->setDefaultValue('NO');
$array['tobacco'] // value is 'NO'
```

Filters
-------

[](#filters)

Filters are callable objects. Filters are used during request properties with getters.

```
use AndyDune\ArrayContainer\ArrayContainer;
$aray = new ArrayContainer(['pipe' => 'handemade', 'pipes_type' => ['lovat', 'canadian']]);
$array->addFilter(function ($value) {
    return strtoupper($value);
});
$array['pipe'] // value is 'HANDEMADE'
```

Modifiers
---------

[](#modifiers)

Modifier is an object of class witch implements AndyDune\\ArrayContainer\\Action\\AbstractAction interface. It can be simple extented without modification main class.

### Add keys to array if not exist.

[](#add-keys-to-array-if-not-exist)

There is source array:

```
$array = [
    'type' => 'good'
];
```

You need to use it inside model. Model waits array with keys: *type*, *key* and *value*

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\KeysAddIfNoExist;
$container = new ArrayContainer();

$defaultValue = 0; // Set this value if array key does not exist.

$container->setAction(new KeysAddIfNoExist($defaultValue))->executeAction('type', 'key', 'value');
$resultArray = $container->getArrayCopy();
```

Result array is:

```
$resultArray = [
    'type' => 'good',
    'key' => 0,
    'value' => 0
];
```

### Array shift maintaining key to data correlations.

[](#array-shift-maintaining-key-to-data-correlations)

It is source array with numeric keys.

```
$arraySource = [
    40 => 'fourty',
    50 => 'figty',
    60 => 'sixty',
];
```

After execution function `array_shift` keys will be lost.

```
array_shift($arraySource);
$arraySource = [
    0 => 'figty',
    1 => 'sixty',
];
```

Array container action helps to avoid it.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\ArrayShift;

$arraySource = [
    40 => 'fourty',
    50 => 'figty',
    60 => 'sixty',
];

$container = new ArrayContainer($arraySource);

$result = $container->setAction(new ArrayShift())->executeAction();

$result == [40 => 'fourty'];

$resultArray =  $container->getArrayCopy();
```

Result array is:

```
[
    50 => 'figty',
    60 => 'sixty',
];
```

### Add value to nested array

[](#add-value-to-nested-array)

We have array structure of witch we don't know. Need to set value to it's nested value with check of existence of nested structure. It changes only given array keys.

```
// Sourse array:
$array = [
    'a' => 1,
    'b' => [
        'c' => 2
    ]
];
$container->setAction(new SetValueIntoNestedArray(22))->executeAction('b', 'cc');
$arrayResult = $container->getArrayCopy();

// Result array is:
$arrayResult = [
    'a' => 1,
    'b' => [
        'c' => 2,
        'cc' => 22
    ]
];
```

Ome more example.

We have stait array with month, year and counts of entities within this date.

```
$data = [[
    'month' => 7,
    'year' => 2020,
    'orderCount' => 2,
    ],
],
[
    'month' => 1,
    'year' => 2020,
    'orderCount' => 20,
    ],
],

...
]
```

We need to recieve something like this:

```
$result = [
    2007 => [
        1 => 2,
        7 => 20
    ]
]
```

Here is code for this:

```
use AndyDune\ArrayContainer\Action\SetValueIntoNestedArray;
use AndyDune\ArrayContainer\ArrayContainer;

$arrayContainer = new ArrayContainer();
foreach($data as $row) {
    $arrayContainer->setAction(new SetValueIntoNestedArray($row['orderCount']))
        ->executeAction($row['year'], $row['month']);
}
$result = $arrayContainer->getArrayCopy();
```

### Remove from array duplicated values

[](#remove-from-array-duplicated-values)

It needs simple to remove values witch duplicates. Here how we can do it.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\RemoveDuplicates;

$array = [
    'a' => 'a',
    'b' => 'b',
    'b1' => 'b',
    'c' => 'c',
];
$container = new ArrayContainer($array);
$count = $container->setAction(new RemoveDuplicates())->executeAction();
$count == 1; // it is count of removed items
$array = $container->getArrayCopy());

$array; // it has no value with key b1
```

### Check is value in nested array

[](#check-is-value-in-nested-array)

There is nested value with any structure. It checks is some value in given array including values in nested arrays.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\InNestedArray;

$array = [
    'a' => 1,
    'b' => [
        'c' => 2
    ]
];
$container = new ArrayContainer($array);
$container->setAction(new InNestedArray(1))->executeAction(); // true
$container->setAction(new InNestedArray('1'))->executeAction(); // true
$container->setAction(new InNestedArray(5))->executeAction(); // false

// With strong type comparision
$container->setAction(new InNestedArray('1', true))->executeAction(); // false
```

Values can be changed before comparision:

```
$array = [
    [
        [
            'name' => 'Ivan'
        ],
        [
            'name' => 'Andrey'
        ],
    ]
];
$container = new ArrayContainer($array);

// false: Ivan != ivan
$container->setAction(new InNestedArray('ivan'))->executeAction();

// true: strtolower to values before compare
$container->setAction((new InNestedArray('ivan'))->setValueMutator(function($value){
    if (!is_string($value)) {
        return $value;
    }
    return strtolower($value);
}))->executeAction();
```

### Create new array with values from current array

[](#create-new-array-with-values-from-current-array)

It needs to create new list of values from any fixed list. The new list must contain random values.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\ExtractRandomItems;

$array = [
    'a',
    'b',
    'c',
    'd',
    'e',
    'f'
];
$container = new ArrayContainer($array);
$arrayNew = $container->setAction(new ExtractRandomItems(3))->executeAction();
```

It leaves keys in new array as it was in source array.

### Concat arrays

[](#concat-arrays)

Function `array_merge` may act not right with associative arrays.

Example down next:

```
$a1 = ['first' => 1, 'second' => 2];
$ar = array_merge($a1, ['second' => 22])

The result is:
$ar == ['first' => 1, 'second' => 22];
```

Concat action helps to do it right:

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\Concat;

$a1 = ['first' => 1, 'second' => 2];

$container = new ArrayContainer($a1);
$result = $container->setAction(new Concat())->executeAction(['second' => 22]);

The result is:
$ar == ['first' => 1, 'second' => 2, 22];
```

### Computes the difference of arrays with additional index check

[](#computes-the-difference-of-arrays-with-additional-index-check)

Compares array1 against array2 and more and returns the difference. It computes arrays recursively.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\ComputeDifferenceOfArrays;

$arrayWait = [
    'r' => 'red',
    'rr' => [
        'r1' => 'red1',
        'rrr' => [
            'r2' => 'red2',
            'r22' => ['red22']
        ],
        'r2' => 'red2',
    ],
    'b' => 'blue'
];

$container = new ArrayContainer($array);
$result = $container->setAction(new ComputeDifferenceOfArrays())->executeAction(
    ['r' => 'red', 'rr' => ['r1' => 'red1', 'rrr' => ['r22' => ['red22']]]]
);

// The resu is:

$arrayWait = [
    'rr' => [
        'rrr' => [
            'r2' => 'red2',
            'r22' => ['red22']
        ],
        'r2' => 'red2',
    ],
    'b' => 'blue'
];
```

It may ignore some keys within result.

```
$container = new ArrayContainer($array);
$result = $container->setAction(
(new ComputeDifferenceOfArrays())->ignoreKeys('r2', ['b'])))->executeAction(
    ['r' => 'red', 'rr' => ['r1' => 'red1']]
);

// The resu is:

$arrayWait = [
    'rr' => [
        'rrr' => [
            'r22' => ['red22']
        ],
    ]
];
```

### Check is array has only fixed keys

[](#check-is-array-has-only-fixed-keys)

It checks source array if it has only this keys.

```
$array = [
    'r' => 'red',
    'rr' => [
        'r1' => 'red1',
    ],
    'b' => 'blue'
];
$container = new ArrayContainer($array);
$result = $container->setAction(new IsOnlyThisKeysInArray())->executeAction('r');
$result == false;

$container = new ArrayContainer($array);
$result = $container->setAction(new IsOnlyThisKeysInArray())->executeAction('r', ['rr']);
$result == false;

$container = new ArrayContainer($array);
$result = $container->setAction(new IsOnlyThisKeysInArray())->executeAction('r', ['rr', 'b']);
$result == true;
```

### Create integer array with values not in sequence

[](#create-integer-array-with-values-not-in-sequence)

There is an array with integer values we have. Values are mixed, not in order and can be duplicated. We can receive array with values witch were skipped.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\GetIntegerNumbersNotInSequence;

$array = [5, 1, 7, 8];
$container = new ArrayContainer($array);
$result = $container->setAction(new GetIntegerNumbersNotInSequence())->executeAction();
// result is:
[2,3,4,6] == $result;
```

### Find max float value in array

[](#find-max-float-value-in-array)

It searches max float value in the given array. Each value is prepared by removing spaces.

```
use AndyDune\ArrayContainer\ArrayContainer;
use AndyDune\ArrayContainer\Action\FindMaxFloatValue;

$container = new ArrayContainer(['- 1', -2.56, 10, ' 1 1 ']);
$result = $container->setAction(new FindMaxFloatValue())->executeAction();
$this->assertEquals(11, $result);
// result is:
11 == $result;
```

Access array with path notation
-------------------------------

[](#access-array-with-path-notation)

Access to array value (more if array is nested) may require validation and check. Path helps make it easily.

```
use AndyDune\ArrayContainer\Path;
$arr = [
'key1' => 'bum',
'key2' => ['key21' => [
    'key211' => 'mub'
]],
];

// To get value with key `key211` you need:
$arr['key2']['key21']['key211'] // mub
// with Path
$arrObject = new Path($arr);
(string)$arr->key2->key21->key211; // mub
```

Set value inside nested array:

```
use AndyDune\ArrayContainer\Path;
$arrObject = new Path($arr);
$arr->key2->key21->key211 = 'bum';

(string)$arr->key2->key21->key211; // 'bum'
$arr->key2->key21->noExist_id->getValue(); // null
```

Build array
-----------

[](#build-array)

MultilineTextToAssociatedArray
------------------------------

[](#multilinetexttoassociatedarray)

It creates array from text with lines as key-values pairs in it.

```
use AndyDune\ArrayContainer\Builder;
use AndyDune\ArrayContainer\BuilderStrategy\MultilineTextToAssociatedArray;

$sourceText = '
one => two
three
=> four

';

$expectResult = [
    'one' => 'two',
    'four',
    'three' => null
];

$builder = new Builder($sourceText, new MultilineTextToAssociatedArray('=>'));

// result is
$expectResult == $builder->execute();
```

MultilineTextAsJsonToAssociatedArray
------------------------------------

[](#multilinetextasjsontoassociatedarray)

It creates array from text with lines as json-like key-values pairs in it.

```
use AndyDune\ArrayContainer\Builder;
use AndyDune\ArrayContainer\BuilderStrategy\MultilineTextAsJsonToAssociatedArray;

$text = '
{
"one":"two",
"two" : 2,
"three":null
}

';

$expectResult = [
    'one' => 'two',
    'two' => 2,
    'three' => null
];

$builder = new Builder($text, new MultilineTextAsJsonToAssociatedArray());
// result is

$expectResult ==  $builder->execute();
```

MarkdownTableToArray
--------------------

[](#markdowntabletoarray)

It creates array from Markdown table.

Read about format [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#tables)

```
use AndyDune\ArrayContainer\Builder;
use AndyDune\ArrayContainer\BuilderStrategy\MultilineTextAsJsonToAssociatedArray;

$text = '
| one | two |
| --- | ---
1 | 2
11
| 12| 13 | 14
';

$expectResult = [
    [
        'one' => 1,
        'two' => 2
    ],
    [
        'one' => '11',
        'two' => null
    ],
    [
        'one' => '12',
        'two' => '13'
    ]
];

$builder = new Builder($text, new MarkdownTableToArray());
$expectResult == $builder->execute();
```

You can build not assoc array like this:

```
use AndyDune\ArrayContainer\Builder;
use AndyDune\ArrayContainer\BuilderStrategy\MultilineTextAsJsonToAssociatedArray;

$text = '
    | one | two |
    1 | 2
    |
    || 5
    11
    | 12| 13 | 14
';

$expectResult = [
    ['one', 'two'],
    [1, 2],
    ['', 5],
    ['11',  null],
    ['12', '13']
];

$builder = new Builder($text, new MarkdownTableToArray());
$expectResult == $builder->execute();
```

MultilineTextToNestedAssociatedArray
------------------------------------

[](#multilinetexttonestedassociatedarray)

It creates array from text with lines as key-values pairs in it. Values are nested arrays.

```
use AndyDune\ArrayContainer\Builder;
use AndyDune\ArrayContainer\BuilderStrategy\MultilineTextToNestedAssociatedArray;

$text = '
one > one,
one > two, one
four > 4, 5, 6
';

$expectResult = [
    'one' => ['one', 'two'],
    'four' => [4, 5, 6],
];

$builder = new Builder($text, new MultilineTextToNestedAssociatedArray());
$expectResult == $builder->execute();
```

StringExplode
-------------

[](#stringexplode)

It does simple string explode procedure with removing empty values or not.

```
use AndyDune\ArrayContainer\Builder;
use AndyDune\ArrayContainer\BuilderStrategy\StringExplode;

$text = '
    one , two,
';

$expectResult = [
    'one', 'two'
];

$builder = new Builder($text, new StringExplode(','));
$expectResult == $builder->execute();
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity68

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~30 days

Recently: every ~4 days

Total

25

Last Release

2255d ago

PHP version history (2 changes)v1.0.0PHP ^5.6 || ^7

v1.3.0PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/79da3b2173a2cefb36abc9b4707cf2c633df8f2c748633ccf64186f5c0e7be6c?d=identicon)[AndyDune](/maintainers/AndyDune)

---

Top Contributors

[![AndyDune](https://avatars.githubusercontent.com/u/3772910?v=4)](https://github.com/AndyDune "AndyDune (45 commits)")

---

Tags

arraysphpphp7strategy-patternphparray

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/andydune-array-container/health.svg)

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

###  Alternatives

[zakirullin/mess

Convenient array-related routine & better type casting

21228.9k2](/packages/zakirullin-mess)

PHPackages © 2026

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