Download the PHP package boxblinkracer/xpatharray without Composer
On this page you can find all versions of the php package boxblinkracer/xpatharray. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download boxblinkracer/xpatharray
More information about boxblinkracer/xpatharray
Files in boxblinkracer/xpatharray
Informations about the package xpatharray
XPathArray - Easy XPath Access for your Arrays
Why XPathArrays instead of Arrays?
...small and simple, but still powerful...
If you use basic Arrays in PHP you are familiar with the array_key_exists
function.
And yes, this does really blow up your code if you have multiple levels within your array.
If you check for existing keys, the only thing you get is a PHP Notice Error
, and that obviously doesn't
result in an Exception.
With XPathArray you get the following:
- Easy XPath Selection in multiple levels, e.g. "/customer/address/street"
- Real XPathKeyNotFound Exceptions instead of PHP Notices
- Default Values for missing keys or values
- ...and a more lightweight code... :)
Installation
This package uses Composer, please checkout the composer website for more information.
The following command will install xpatharray
into your project.
It will also add a new entry in your composer.json
and update the composer.lock
as well.
This package follows the PSR-4 convention names for its classes, which means you can easily integrate
xpatharray
classes loading in your own autoloader.
What now?
Here are a few examples what to do with XPathArray objects.
With Exceptions
In the first example, we access the content of our customer array using XPath syntax.
If a key is not found, we will get a XPathNotFoundException
.
This is perfect, if you want to simply use and validate your structure at once.
Without Exceptions
In the next example, we want to access the same keys, but we do not want to get any exceptions. So we just provide a default value, that will be returned if the key is either NULL or has not been found at all.
This is perfect, if you want to work with optional nodes within your array.
Copying / License
This repository is distributed under the MIT License (MIT). You can find the whole license text in the LICENSE file.