room11/dom-utils

Utility functions for the PHP DOM extension

v1.1.1 2016-10-19 15:15 UTC

This package is not auto-updated.

Last update: 2024-10-26 19:27:16 UTC


README

Utility functions for the PHP DOM extension.

Required PHP Version

  • PHP 7.0+

Installation

$ composer require room11/dom-utils

Usage

default_charset

Gets and sets the default charset used by DOMUtils functions.

default_charset(string $charSet = ''): string

When the supplied $charSet is empty, just return the current value. When a new value is supplied, change the default and return the old one.

  • string $charSet - The new default character set.

domdocument_load_html

Loads a HTML string into a DOMDocument object, with error handling and character set normalization.

domdocument_load_html(string $html, int $options = 0, string $charSet = ''): \DOMDocument

Loads a HTML string into a DOMDocument object, with error handling and character set normalization.

  • string $html - The HTML string to load.
  • int $options - A bit mask of LibXML options to use when loading the document.
  • string $charSet - The character set to use when loading the document. Defaults to default_charset().

Throws a LibXMLFatalErrorException when loading the document fails.

domdocument_process_html_docs

Processes a set of HTML strings into DOMDocument objects and invokes a callback for each one.

domdocument_process_html_docs($htmlStrings, callable $callback, int $options = 0, string $charSet = ''): \DOMDocument

A DOMDocument object will be passed to the first argument of the callback, and an array of LibXMLError objects for the document to the second. The third argument is a boolean which is true if the document could not be loaded. The callback may return boolean false to break the iteration. Any other return value will be ignored.

  • string[] $htmlStrings - An iterable set of HTML strings to process.
  • callable(\DOMDocument, \LibXMLError[], bool) $callback - The callback to invoke for each document.
  • int $options - A bit mask of LibXML options to use when loading the documents.
  • string $charSet - The character set to use when loading the documents. Defaults to default_charset().