Search by

lightools / xml

janedbal

Simple and safe parsing of XML and HTML sources.

Package info

github.com/lightools/xml

pkg:composer/lightools/xml

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 127 759

Dependents: 7

Suggesters: 1

Stars: 10

Open Issues: 0

v4.0.0 2026-08-26 14:48 UTC

Requires

  • php: >=8.4
  • ext-dom: *
  • ext-libxml: *

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 7e836db5408036bc7b7733965ef64fbf024e47e0

Published on Packagist.org on 2026-08-26 14:59 UTC

This package is auto-updated.

Last update: 2026-08-26 14:59:57 UTC

README

This library provides simple interface for loading XML or HTML strings to Dom\XMLDocument or Dom\HTMLDocument objects (the DOM API introduced in PHP 8.4). It prevents some known vulnerabilities and allows you to handle LibXML errors simply by catching XmlException as you can see below.

Installation

$ composer require lightools/xml

Simple usage

The loadXml method returns Dom\XMLDocument and the loadHtml method returns Dom\HTMLDocument (parsed by the spec-compliant HTML5 parser). The HTML5 parser recovers from malformed markup, so loadHtml throws only for empty input. If you prefer working with SimpleXmlElement, you can use simplexml_import_dom function.

$xml = '<?xml version="1.0"?><root>text</root>';
$html = '<!doctype html><title>Foo</title>';

$loader = new Lightools\Xml\XmlLoader();

try {
    $xmlDocument = $loader->loadXml($xml);
    $htmlDocument = $loader->loadHtml($html);

} catch (Lightools\Xml\XmlException $e) {
    // process exception
}

How to run checks

$ composer check

Versions

  • v1.x is for PHP 5.4 and higher
  • v2.x is for PHP 7.1 and higher
  • v3.x is for PHP 8.0 and higher
  • v4.x is for PHP 8.4 and higher (returns Dom\XMLDocument / Dom\HTMLDocument instead of DOMDocument)