PHP Classes
elePHPant
Icontem

PHP Dot Notation Array Access: Access array elements using path strings with dots

Recommend this page to a friend!
  Info   View files Documentation   View files View files (7)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2019-10-23 (20 days ago) RSS 2.0 feedNot yet rated by the usersTotal: 56 All time: 9,595 This week: 343Up
Version License PHP version Categories
php-dot-array 1.0.0Custom (specified...7PHP 5, Data types
Description Author

This package can be used to access array elements using path strings with dots.

It can perform several types of operations using strings to refer to indexes of elements in arrays that can have one or more dimensions.

The class provides functions that can perform operations like setting, getting, deleting array element values, check if an element exists with a given path, return array element count, etc..

Name: Moamen Eltouny <contact>
Classes: 3 packages by
Country: Egypt Egypt
Age: 26
All time rank: 427248 in Egypt Egypt
Week rank: 107 Up2 in Egypt Egypt Up

 

Details

[PHP] DotArray - Accessing arrays using dot notation and asterisk

Latest Stable Version Total Downloads License

DotArray provides an quick/easy access to arrays of data with dot-notation and asterisk.

//Get all users names with DotArray
$names = $dot->get('users.*.name');

Examples

Traditional way

$array['users']['raggi']['name'] = 'Moamen Eltouny';

echo $array['users']['raggi']['name']; // Moamen Eltouny

DotArray way (with DotArray Object)

$dot = dot(); // Creating DotArray Object
$dot->set('users.raggi.name', 'Moamen Eltouny');

// Getting [DotArray way]
echo $dot->get('users.raggi.name');

// OR Getting [ArrayAccess way]
echo $dot['users.raggi.name'];

Install

Install the latest version using Composer:

$ composer require raggitech/php-dot-array

Usage

Create a new DotArray object:

$dot = new \RaggiTech\DotArray\DotArray;

// With existing array
$dot = new \RaggiTech\DotArray\DotArray($array);

OR You can use a helper function to create the object:

$dot = dot();

// With existing array
$dot = dot($array);

Methods

DotArray has the following methods:

<a name="set"></a>

set()

Sets a given key / value pair:

$dot->set('users.raggi.created_at', date('r', time()));

// ArrayAccess
$dot['users.raggi.created_at'] = date('r', time());

<a name="get"></a>

get()

Returns the value of a given key:

print_r($dot->get('users.*.name'));

// ArrayAccess
print_r($dot['users.*.name']);

Returns a given default value, if the given key doesn't exist:

print_r($dot->get('users.*.name', 'Raggi'));

<a name="tojson"></a>

toJson()

Returns the value of a given key (like get() method) as JSON:

echo $dot->toJson('users');

Returns all the stored items (like get() method) as JSON:

echo $dot->toJson();

<a name="all"></a>

all()

Returns all the stored items as an array:

$values = $dot->all();

<a name="delete"></a>

delete()

Deletes the given key:

$dot->delete('users.*.name');

// ArrayAccess
unset($dot['users.*.name']);

<a name="clear"></a>

clear()

Deletes all the stored items:

$dot->clear();

<a name="has"></a>

has()

Checks if a given key exists (returns boolean):

$dot->has('users.raggi.name');

// ArrayAccess
isset($dot['users.raggi.name']);

<a name="count"></a>

count()

Returns the number of the root Items:

$dot->count();

// Or use count() function [Countable Way]
count($dot);

Returns the number of items in a given key:

$dot->count('users');

<a name="isempty"></a>

isEmpty()

Checks if a given key is empty (returns boolean):

$dot->isEmpty('users.raggi.name');

// ArrayAccess
empty($dot['users.raggi.name']);

Checks the whole DotArray object:

$dot->isEmpty();

<a name="setarray"></a>

setArray()

Replaces all items in DotArray object with a given array:

$dot->setArray($array);

<a name="setreference"></a>

setReference()

Replaces all items in Dot object with a given array as a reference:

$dot->setReference($array);

License

MIT license

  Files folder image Files  
File Role Description
Files folder imagesrc (2 files)
Accessible without login Plain text file .travis.yml Data Auxiliary data
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file composer.lock Data Auxiliary data
Accessible without login Plain text file LICENSE Lic. License text
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files  /  src  
File Role Description
  Plain text file DotArray.php Class Class source
  Accessible without login Plain text file helper.php Aux. Auxiliary script

 Version Control Unique User Downloads Download Rankings  
 100%
Total:56
This week:0
All time:9,595
This week:343Up