2017 © Pedro Peláez
 

library dot-access-data

Given a deep data structure, access data by dot notation.

image

dflydev/dot-access-data

Given a deep data structure, access data by dot notation.

  • Thursday, December 21, 2017
  • by simensen
  • Repository
  • 6 Watchers
  • 151 Stars
  • 2,664,741 Installations
  • PHP
  • 45 Dependents
  • 0 Suggesters
  • 8 Forks
  • 5 Open issues
  • 5 Versions
  • 17 % Grown

The README.md

Dot Access Data

Latest Version Total Downloads Software License Build Status Coverage Status Quality Score, (*1)

Given a deep data structure, access data by dot notation., (*2)

Requirements

  • PHP (7.1+)

For PHP (5.3+) please refer to version 1.0., (*3)

Usage

Abstract example:, (*4)

use Dflydev\DotAccessData\Data;

$data = new Data;

$data->set('a.b.c', 'C');
$data->set('a.b.d', 'D1');
$data->append('a.b.d', 'D2');
$data->set('a.b.e', ['E0', 'E1', 'E2']);

// C
$data->get('a.b.c');

// ['D1', 'D2']
$data->get('a.b.d');

// ['E0', 'E1', 'E2']
$data->get('a.b.e');

// true
$data->has('a.b.c');

// false
$data->has('a.b.d.j');


// 'some-default-value'
$data->get('some.path.that.does.not.exist', 'some-default-value');

// throws a MissingPathException because no default was given
$data->get('some.path.that.does.not.exist');

A more concrete example:, (*5)

use Dflydev\DotAccessData\Data;

$data = new Data([
    'hosts' => [
        'hewey' => [
            'username' => 'hman',
            'password' => 'HPASS',
            'roles'    => ['web'],
        ],
        'dewey' => [
            'username' => 'dman',
            'password' => 'D---S',
            'roles'    => ['web', 'db'],
            'nick'     => 'dewey dman',
        ],
        'lewey' => [
            'username' => 'lman',
            'password' => 'LP@$$',
            'roles'    => ['db'],
        ],
    ],
]);

// hman
$username = $data->get('hosts.hewey.username');
// HPASS
$password = $data->get('hosts.hewey.password');
// ['web']
$roles = $data->get('hosts.hewey.roles');
// dewey dman
$nick = $data->get('hosts.dewey.nick');
// Unknown
$nick = $data->get('hosts.lewey.nick', 'Unknown');

// DataInterface instance
$dewey = $data->getData('hosts.dewey');
// dman
$username = $dewey->get('username');
// D---S
$password = $dewey->get('password');
// ['web', 'db']
$roles = $dewey->get('roles');

// No more lewey
$data->remove('hosts.lewey');

// Add DB to hewey's roles
$data->append('hosts.hewey.roles', 'db');

$data->set('hosts.april', [
    'username' => 'aman',
    'password' => '@---S',
    'roles'    => ['web'],
]);

// Check if a key exists (true to this case)
$hasKey = $data->has('hosts.dewey.username');

Data may be used as an array, since it implements ArrayAccess interface:, (*6)

// Get
$data->get('name') === $data['name']; // true

$data['name'] = 'Dewey';
// is equivalent to
$data->set($name, 'Dewey');

isset($data['name']) === $data->has('name');

// Remove key
unset($data['name']);

/ can also be used as a path delimiter:, (*7)

$data->set('a/b/c', 'd');
echo $data->get('a/b/c'); // "d"

$data->get('a/b/c') === $data->get('a.b.c'); // true

License

This library is licensed under the MIT License - see the LICENSE file for details., (*8)

Community

If you have questions or want to help out, join us in the #dflydev channel on irc.freenode.net., (*9)

The Versions

21/12 2017

dev-master

9999999-dev https://github.com/dflydev/dflydev-dot-access-data

Given a deep data structure, access data by dot notation.

  Sources   Download

MIT

The Requires

  • php ^7.0

 

The Development Requires

dot access data notation

21/12 2017

v2.0.0

2.0.0.0 https://github.com/dflydev/dflydev-dot-access-data

Given a deep data structure, access data by dot notation.

  Sources   Download

MIT

The Requires

  • php ^7.0

 

The Development Requires

dot access data notation

20/01 2017

v1.1.0

1.1.0.0 https://github.com/dflydev/dflydev-dot-access-data

Given a deep data structure, access data by dot notation.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

dot access data notation

13/08 2015

v1.0.1

1.0.1.0 https://github.com/dflydev/dflydev-dot-access-data

Given a deep data structure, access data by dot notation.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

dot access data notation

17/07 2012

v1.0.0

1.0.0.0 https://github.com/dflydev/dflydev-dot-access-data

Given a deep data structure, access data by dot notation.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

dot access data notation