vaclavvanik/dom-loader

Load DOM document safety

1.0.1 2021-11-10 07:24 UTC

Requires

• php: ^7.3 || ^8.0
• ext-dom: *
• ext-libxml: *

MIT

• Václav Vaník

• xml
• dom
• load

README

This package provides a safety way to load string or file to DOMDocument.

Install

You can install this package via composer.

composer require vaclavvanik/dom-loader

Usage

<?php

declare(strict_types=1);

use VaclavVanik\DomLoader;

$dom = DomLoader\DomLoader::loadFile($file);
// or
$dom = DomLoader\DomLoader::loadString($string);

passing dom load $options is also available:

<?php

declare(strict_types=1);

use VaclavVanik\DomLoader;

use const LIBXML_PARSEHUGE;

$dom = DomLoader\DomLoader::loadFile($file, LIBXML_PARSEHUGE);
// or
$dom = DomLoader\DomLoader::loadString($string, LIBXML_PARSEHUGE);

and finally loading into custom DOMDocument is supported:

<?php

declare(strict_types=1);

use DOMDocument;
use VaclavVanik\DomLoader;

$dom = DomLoader\DomLoader::loadFile($file, 0, new DOMDocument('1.0', 'utf-8'));
// or
$dom = DomLoader\DomLoader::loadString($string, 0, new DOMDocument('1.0', 'utf-8'));

Exceptions

load methods throw:

• Exception\LibXml if xml file parsing failed.
• Exception\Runtime if error occurs when reading file.
• Exception\ValueError if filename or xml string is empty.

Run check - coding standards and php-unit

Install dependencies:

make install

Run check:

make check

Changelog

Please see CHANGELOG for more information what has changed recently.

License

The MIT License (MIT). Please see License File for more information.