welldom/welldom

XML toolbox for PHP

v1.0.2 2014-09-23 15:39 UTC

Requires

• php: >=5.3.0

Suggests

• symfony/css-selector: Provides facilities is you prefers CSS to Xpath

MIT

• Jérôme Tamarelle
• Jérôme MACIAS

• xml
• xslt
• dom
• Xpath

README

Welldom try to ease the use of DOM to manipulate XML documents with the following features :

• Error management
• Unique encoding for XML input/output
• Simple methods to query and manipulate the DOM with Xpath
• Batch on node list
• Node rename & remove methods

Requirements

• PHP 5.3+
• PHPUnit 5.6+

Installation

The library follow the PSR-0 naming convention. To load the library, use any compliant class loader or simply require the src/autoload.php file.

require __DIR__ . '/path/to/expdom/src/autoload.php';

Usage

Load an XML document:

<?php

use Welldom\Document;

$doc = new Document('UTF-8');

if (false === $doc->load('data.xml')) {
    $errors = $doc->getLastErrors();
    throw new Exception("XML Loading error\n" . implode("\n", $errors));
}

// ... enjoy your DOM document

Find a node values using XPath:

$values = array(
    'title' => $doc->getNodeValue('//book/title'),
    'lang' => $doc->getNodeValue('//book/title/@lang', 'en'),
);

Execute action on each node matching a given Xpath:

$doc->query('//foo/bar[@lang=de]')
    ->remove();

$doc->query('//foo/bar[@lang=english]/@lang')
    ->setValue('en');

Run tests

Run PHPUnit test suite:

phpunit

License

For the full copyright and license information, please view the LICENSE file that was distributed with this source code.

Contributors:

• Jérôme Macias
• Jérôme Tamarelle