README

simplehtmldom is a fast and reliable HTML DOM parser for PHP.

This is a fork of the Simple HTML DOM Parser project which aims to make "composer" compatibility better and clean-up some code, introduce type-safety and generally keep the project up-to-date.

Key features

• Purely PHP-based DOM parser (no XML extensions required).
• Works with well-formed and broken HTML documents.
• Loads webpages, local files and document strings.
• Supports CSS selectors.

Requirements

simplehtmldom requires PHP 8.1 or higher with ext-iconv enabled. Following extensions enable additional features of the parser:

• ext-mbstring (recommended)
  Enables better detection for multi-byte documents.
• ext-curl
  Enables cURL support for the class HtmlWeb.
• ext-openssl (recommended when using cURL)
  Enables SSL support for cURL.

Installation

composer require php-core/simplehtmldom

Usage

<?php
require_once __DIR__. '/vendor/autoload.php';
use PHPCore\SimpleHtmlDom\HtmlWeb;

$client = new HtmlWeb();
$html = $client->load('https://www.google.com/search?q=simplehtmldom');

// Returns the page title
echo $html->find('title', 0)->plaintext . PHP_EOL;

Find more examples in the installation folder under examples.

Documentation

The documentation for this library is hosted at https://php-core.com/simplehtmldom/

If you want to contribute code to the project, simply do a pull-request towards the project repository.

Authors

• S.C. Chen
• John Schlick
• logmanoriginal
• Rus Carroll
• Yousuke Kumakura
• Vadim Voituk
• PHPCore

License

The source code for simplehtmldom is licensed under the MIT license. For further information read the LICENSE file in the root directory (should be located next to this README file).

Technical notes

simplehtmldom is a purely PHP-based DOM parser that doesn't rely on external libraries like libxml, SimpleXML or PHP DOM. Doing so provides better control over the parsing algorithm and a much simpler API that even novice users can learn to use in a short amount of time.