A tool to encode/decode between EDN and PHP data structures.

When converting from EDN to PHP the conversion is lossy as the richness of datatypes supported by EDN is not available in PHP. So a conversion from EDN to PHP and back to EDN would not lose you data, but it would lose type information.

The interface is via some static functions on the Edhen class. To decode an EDN element...

$element = Edhen::decode('(1 :foo [2])');

// array(1, ':foo', array(2))

If you have EDN with multiple elements, you can use decodeAll

$elements = Edhen::decodeAll(':foo :bar :baz');

// array(':foo', ':bar', ':baz')

Then for encoding use the encode function, passing it the data to encode...

$ednString = Edhen::encode(array(1, 2));

// '[1 2]'

When decoding EDN to PHP...

When encoding PHP to EDN...

The decision on if an array is to be converted to a vector or hashmap is done by checking its keys. If any of the keys are non-numeric then a hashmap is used.

EDN is generated as a single string, no pretty-printing is currently supported. Another tool should be used for this.

To implement your own tag handlers, create a class which implements the Edhen\TagHandler interface and pass it in an array as the second argument to decode/decodeAll

$myHandler = new MyCustomTagHandler();

$element = Edhen::decode($edn, array($myHandler));

You can see an example in the tests.

Edhen can be installed via Composer.