cabello / selector
Extract information from JSON, StdClass in a fashionable way
Requires
- php: >=5.3
Requires (Dev)
- phpunit/phpunit: 3.7.*
This package is not auto-updated.
Last update: 2024-11-09 15:36:11 UTC
README
Disclaimer
If you found this project but think it's incomplete or doesn't meet your needs, try Property Access.
Problem
Imagine that you have a StdClass
(possibly created by a json_decode
) instance full of attributes you want to retrieve. So you do something like this:
$username = $photo->owner->username;
What happens if username is undefined and/or owner?
$username = isset($photo) && isset($photo->owner) && isset($photo->owner->username)
? $photo->owner->username
: 'anonymous';
Imagine this kind of logic spread all over your codebase. What a mess!
Solution
Selector turns the horrible code above into this:
$photoSelector = Selector($photo);
$username = $photoSelector->getOne('owner.username', 'anonymous');
You never have to worry again about checking if the StdClass
have the properties you need, and as a plus you receive several ways of retrieving data.
Features
Selector
Selector::getOne
Description
Parameters
Return Values
Examples
Example #1
The above example will output:
Example #2
The above example will output:
Selector::getAll
Description
Parameters
Return Values
Examples
Example #1
The above example will output:
Example #2
The above example will output:
Selector::findOne
Description
Parameters
Return Values
Examples
Example #1
The above example will output:
Example #2
The above example will output:
Selector::findAll
Description
Parameters
Return Values
Examples
Example #1
The above example will output:
Example #2
The above example will output:
Selector::getDictionary
Description
Parameters
Return Values
Examples
Example #1
The above example will output:
Example #2
The above example will output:
Developer
Assuming you have composer.phar
installed, it's simple to contribute to Selector, fork, clone your repository and run:
cd selector # your clone folder
composer.phar install --dev
vendor/bin/phpunit tests
And you are ready to write new tests, contributions and sending pull requests.