HTML Parsing with PHP 8.4's New DOM\HTMLDocument Class

Fishbite — Tue, 22 Jul 2025 14:37:05 +0000

Intro: PHP 8.4's New `DOM\HTMLDocument` Class

PHP 8.4 quietly introduced a powerful new class: DOM\HTMLDocument. Unlike the traditional DOMDocument, this class is tailor-made for parsing HTML5, not XML, and brings a more forgiving and intuitive DOM interface to modern PHP.

Note: This requires PHP 8.4+ and the dom extension to be enabled.

What's the Difference?

DOM\HTMLDocument is more HTML5-native than the classic DOMDocument, which is XML-centric and strict about malformed markup. If you’ve ever fought with DOMDocument silently failing or auto-correcting tags, this new API is for you.

Sample Project on GitHub

I created a GitHub repo showing how to:

Load and parse HTML5 files
Access elements like <head> and <title>
Extract <meta> tags
Cleanly render DOM elements as HTML

GitHub Repo: github.com/Fishbite/php-dom-htmldocument-examples

Example: Extracting the First Element in `<head>`

use DOM\HTMLDocument;

require __DIR__ . '/vendor/autoload.php';

$dom = HTMLDocument::createFromFile('./html/sample.html');
$head = $dom->getElementsByTagName('head')->item(0);

foreach ($head->childNodes as $child) {
    if ($child instanceof DOM\Element) {
        echo "First tag in <head>: <{$child->tagName}>\n";
        echo $dom->saveHTML($child);
        break;
    }
}

What's Included in the Repo?

extract_head.php: Show the first child of
extract_title.php: Grab the text
list_meta.php: List all tags
sample.html: Minimal HTML5 doc for testing
composer.json: Basic autoloading config

You can run each file individually from the command line or route them through a browser if preferred.

What’s Next?

There’s very little official documentation or community content around DOM\HTMLDocument, so this is a good time to explore it together. Feedback, suggestions, or PRs are more than welcome!

Let’s help get the word out and make working with HTML in PHP a whole lot nicer.

DEV Community: Fishbite