https://github.com/mindplay-dk/easyxml

XML-reader with a functional approach
https://github.com/mindplay-dk/easyxml

Last synced: 3 months ago
JSON representation

XML-reader with a functional approach

• Host: GitHub
• URL: https://github.com/mindplay-dk/easyxml
• Owner: mindplay-dk
• Created: 2012-11-26T18:49:02.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2018-03-20T08:32:14.000Z (almost 7 years ago)
• Last Synced: 2024-04-20T08:43:35.765Z (8 months ago)
• Language: PHP
• Homepage:
• Size: 34.2 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
mindplay/easyxml

----------------

[![Build Status](https://travis-ci.org/mindplay-dk/easyxml.svg?branch=master)](https://travis-ci.org/mindplay-dk/easyxml)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/mindplay-dk/easyxml/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/mindplay-dk/easyxml/?branch=master)

[![Code Coverage](https://scrutinizer-ci.com/g/mindplay-dk/easyxml/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/mindplay-dk/easyxml/?branch=master)

Functional XML-reader for PHP 5.3+.

A somewhat different approach to reading/parsing XML files with PHP, using a hierarchy

of anonymous functions (closures) reflecting the hierarchy of the XML document itself.

This is useful when reading structured XML documents - e.g. XML documents with a

predictable structure. It's probably less than enjoyable when reading unstructured

documents, such as XHTML documents.

Parsing happens on-the-fly, e.g. avoiding the overhead of loading an entire document

into memory and performing repetitive queries against it. This approach is memory

efficient, enabling you to parse very large documents in a streaming fashion - it is

not super fast (throughput ~500 KB/sec on my laptop) but XML parsing is never truly

fast, so you should definitely always cache the parsed results.

Usage

-----

Let's say you wish to read the following XML file:

```XML

    

        

    

    

        

    

```

Your reader might look something like this:

```PHP

$doc = new Parser();

$doc['cats/cat'] = function (Visitor $cat, $name) {

    echo "a cat named: {$name}\n";

    $cat['kitten'] = function ($name) {

        echo "a kitten named: {$name}\n";

    };

};

$doc->parseFile('my_cats.xml');

```

The output would be this:

```

a cat named: whiskers

a kitten named: mittens

a cat named: tinker

a kitten named: binky

```

If it's not obvious, the path `cats/cat` designates a `` node inside a `` node.

You can also match text-nodes, e.g. a path like `foo/bar#text` will match `YO` in `YO`.

And finally, you can use `#end` to match closing tags, if needed.

Incidentally, I don't actually have cats - but if I did, you can bet those would be their names.

See "test.php" and "example/cd_catalog.php" for more examples of how to use this.