zzal/cakephp-hash

XPath-like path syntax for complex arrays using awesome cakePHP’s Hash class

dev-master 2013-05-22 18:04 UTC

Requires

• php: >=5.3.0

MIT

• CakePHP
• Alain Duchesneau

• array
• Xpath
• Laravel 4

README

Please note that this package is in beta develpment phase.

This is simply a wrapper package to help you use the awesome cakePHP’s Hash class in your non-cakePHP project (using composer). This helper class let you manipulate complex PHP arrays using Xpath-like syntax.

See cakePHP documentation.

Installation

Install this package through Composer. To do so, edit your project's composer.json file to require zzal/cakephp-hash.

"require": {
	"zzal/cakephp-hash": "*"
}

Then, add this inside the "autoload" section of this file:

"autoload": {
	"classmap": [
		…
	],
    "psr-0": {
    	"CakePHP\\Utility\\": "vendor/zzal/cakephp-hash/Hash"
    }

Finally, use Composer from the Terminal:

composer install

Basic Usage

As Laravel 4 already have a class named Hash, I suggest that you use the cakePHP Hash class with an alias, like in the following example (routes.php):

<?php

use CakePHP\Utility\Hash as ArrayXPath;

Route::get('/', function()
{
	$records = array(
		array(
		    'pages' => array(
		    	array('id' => 1, 'title' => 'One'),
		    	array('id' => 2, 'title' => 'Two'),
		    	array('id' => 3, 'title' => 'Three'),
			)
		)
	);
	
	$result = ArrayXPath::extract($records, '{n}.pages.{n}[id=2]');

	var_dump($result);
});

And the result would be:

array(1) {
  [0]=>
  array(2) {
    ["id"]=>
    int(2)
    ["title"]=>
    string(3) "Two"
  }
}