包简介

Yii Array Helper

README 文档

README

Yii Arrays

The package provides:

ArrayHelper that has static methods to work with arrays;
ArraySorter that has static methods for sort arrays;
ArrayAccessTrait provides the implementation for \IteratorAggregate, \ArrayAccess and \Countable;
ArrayableInterface and ArrayableTrait for use in classes who want to support customizable representation of their instances.

Requirements

PHP 8.1 - 8.5.

Installation

composer require yiisoft/arrays

ArrayHelper usage

Array helper methods are static so usage is like the following:

$username = \Yiisoft\Arrays\ArrayHelper::getValue($_POST, 'username');

Overall the helper has the following method groups.

Getting data

getValue
getValueByPath
getColumn
getObjectVars

Setting data

addValue
addValueByPath
setValue
setValueByPath

Removing data

remove
removeByPath
removeValue

Detecting array types

isIndexed
isAssociative

HTML encoding and decoding values

htmlDecode
htmlEncode

Testing against arrays

isIn
isSubset

Transformation

index
group
filter
map
merge
parametrizedMerge
renameKey
toArray

Other

keyExists
pathExists

ArraySorter usage

Array sorter has one static method which usage is like the following:

\Yiisoft\Arrays\ArraySorter::multisort($data, ['age', 'name'], [SORT_ASC, SORT_DESC]);

ArrayAccessTrait usage

ArrayAccessTrait provides the implementation for \IteratorAggregate, \ArrayAccess and \Countable.

Note that ArrayAccessTrait requires the class using it contain a property named data which should be an array. The data will be exposed by ArrayAccessTrait to support accessing the class object like an array.

Example of use:

use \Yiisoft\Arrays\ArrayAccessTrait;

class OfficeClassification implements \IteratorAggregate, \ArrayAccess, \Countable
{
    use ArrayAccessTrait;

    public array $data = [
        'a' => 'Class A',
        'b' => 'Class B',
        'c' => 'Class C',
    ];
}

$classification = new OfficeClassification();

echo 'Count classes: ' . $classification->count() . "\n"; // 3

$iterator = $classification->getIterator();
while ($iterator->valid()) {
    echo $iterator->current() . "\n"; // Class A, Class B, Class C
    $iterator->next();
}

ArrayableInterface and ArrayableTrait usage

ArrayableInterface and its implementation ArrayableTrait intended for use in classes who want to support customizable representation of their instances.

Example of use:

use \Yiisoft\Arrays\ArrayableTrait;
use \Yiisoft\Arrays\ArrayableInterface;

class Car implements ArrayableInterface
{
    use ArrayableTrait;

    public string $type = 'Crossover';
    public string $color = 'Red';
    public int $torque = 472;
}

$car = new Car();

$data = $car->toArray(['type', 'color']); // ['type' => 'Crossover', 'color' => 'Red']