Simple HTML DOM: Manipulate HTML elements using DOMDocument

Recommend this page to a friend!

Download

Info

Example

Files

Install with Composer

Download

Reputation

Support forum

Blog

Links

Last Updated		Ratings				Unique User Downloads		Download Rankings
2025-05-07 (-6 hours ago)		75%				Total: 488		All time: 5,894 This week: 488

Version		License		PHP version		Categories
`voku-simple_html_dom` 2.0.79		MIT/X Consortium ...		5.3		HTML, PHP 5, Parsers

Collaborate with this project

Authors

dimabdc
Lars Moelleken

Contributor

Lars Moelleken

simple_html_dom - github.com

Description

This class can manipulate HTML elements using DOMDocument

This is a fork of SimpleHTMLDOM package that uses DOMDocument classes instead of HTML string manipulation.

It can parse and tolerate invalid HTML and supports UTF-8 documents

It can search tags on a HTML page with selectors just like jQuery.

Lars Moelleken

Performance

Level

Name:	Lars Moelleken `<contact>`
Classes:	25 packages by Lars Moelleken
Country:	Germany
Age:	37
All time rank:	621	40 in Germany
Week rank:	46	2 in Germany

Level 5

Innovation award

Nominee: 11x

Winner: 1x

Example


<?php



use voku\helper\HtmlDomParser;



require_once '../vendor/autoload.php';



// -----------------------------------------------------------------------------

// descendant selector

$str = <<<HTML

<div>

    <div>

        <div class="foo bar">ok</div>

    </div>

</div>

HTML;



$html = HtmlDomParser::str_get_html($str);

echo $html->find('div div div', 0)->innertext . '<br>'; // result: "ok"



// -----------------------------------------------------------------------------

// nested selector

$str = <<<HTML

<ul id="ul1">

    <li>item:<span>1</span></li>

    <li>item:<span>2</span></li>

</ul>

<ul id="ul2">

    <li>item:<span>3</span></li>

    <li>item:<span>4</span></li>

</ul>

HTML;



$html = HtmlDomParser::str_get_html($str);

foreach ($html->find('ul') as $ul) {

    foreach ($ul->find('li') as $li) {

        echo $li->innertext . '<br>';

    }

}



// -----------------------------------------------------------------------------

// parsing checkbox

$str = <<<HTML

<form name="form1" method="post" action="">

    <input type="checkbox" name="checkbox1" value="checkbox1" checked>item1<br>

    <input type="checkbox" name="checkbox2" value="checkbox2">item2<br>

    <input type="checkbox" name="checkbox3" value="checkbox3" checked>item3<br>

</form>

HTML;



$html = HtmlDomParser::str_get_html($str);

foreach ($html->find('input[type=checkbox]') as $checkbox) {

    if ($checkbox->checked) {

        echo $checkbox->name . ' is checked<br>';

    } else {

        echo $checkbox->name . ' is not checked<br>';

    }

}

Details

:scroll: Simple Html Dom Parser for PHP

A HTML DOM parser written in PHP - let you manipulate HTML in a very easy way! This is a fork of PHP Simple HTML DOM Parser project but instead of string manipulation we use DOMDocument and modern php classes like "Symfony CssSelector".

PHP 7.0+ & 8.0 Support
PHP-FIG Standard
Composer & PSR-4 support
PHPUnit testing via Travis CI
PHP-Quality testing via SensioLabsInsight
UTF-8 Support (more support via "voku/portable-utf8")
Invalid HTML Support (partly ...)
Find tags on an HTML page with selectors just like jQuery
Extract contents from HTML in a single line

Install via "composer require"

composer require voku/simple_html_dom
composer require voku/portable-utf8 # if you need e.g. UTF-8 fixed output

Quick Start

use voku\helper\HtmlDomParser;

require_once 'composer/autoload.php';

...
$dom = HtmlDomParser::str_get_html($str);
// or 
$dom = HtmlDomParser::file_get_html($file);

$element = $dom->findOne('#css-selector'); // "$element" === instance of "SimpleHtmlDomInterface"

$elements = $dom->findMulti('.css-selector'); // "$elements" === instance of SimpleHtmlDomNodeInterface<int, SimpleHtmlDomInterface>

$elementOrFalse = $dom->findOneOrFalse('#css-selector'); // "$elementOrFalse" === instance of "SimpleHtmlDomInterface" or false

$elementsOrFalse = $dom->findMultiOrFalse('.css-selector'); // "$elementsOrFalse" === instance of SimpleHtmlDomNodeInterface<int, SimpleHtmlDomInterface> or false
...

Examples

github.com/voku/simple_html_dom/tree/master/example

API

github.com/voku/simple_html_dom/tree/master/README_API.md

Support

For support and donations please visit Github | Issues | PayPal | Patreon.

For status updates and release announcements please visit Releases | Twitter | Patreon.

For professional support please contact me.

Thanks

Thanks to GitHub (Microsoft) for hosting the code and a good infrastructure including Issues-Managment, etc.
Thanks to IntelliJ as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
Thanks to Travis CI for being the most awesome, easiest continous integration tool out there!
Thanks to StyleCI for the simple but powerfull code style check.
Thanks to PHPStan && Psalm for relly great Static analysis tools and for discover bugs in the code!

License

Files (89)

File	Role	Description
`.github` (3 files, 1 directory)
`build` (2 files, 1 directory)
`example` (16 files)
`src` (1 directory)
`tests` (12 files, 1 directory)
`.editorconfig`	Data	Auxiliary data
`.scrutinizer.yml`	Data	Auxiliary data
`.styleci.yml`	Data	Auxiliary data
`.travis.yml`	Data	Auxiliary data
`CHANGELOG`	Data	Auxiliary data
`composer.json`	Data	Auxiliary data
`LICENSE`	Lic.	License text
`phpcs.php_cs`	Example	Example script
`phpstan.neon`	Data	Auxiliary data
`phpunit.xml`	Data	Auxiliary data
`README.md`	Doc.	Documentation
`README_API.md`	Doc.	Documentation

Files (89)

.github

File	Role	Description
`workflows` (1 file)
`CONTRIBUTING.md`	Data	Auxiliary data
`FUNDING.yml`	Data	Auxiliary data
`ISSUE_TEMPLATE.md`	Data	Auxiliary data

Files (89)

.github

workflows

File	Role	Description
`ci.yml`	Data	Auxiliary data

Files (89)

build

File	Role	Description
`docs` (1 file)
`composer.json`	Data	Auxiliary data
`generate_docs.php`	Class	Class source

Files (89)

build

docs

File	Role	Description
`api.md`	Data	Auxiliary data

Files (89)

example

File	Role	Description
`example_add_content.php`	Example	Example script
`example_advanced_selector.php`	Example	Example script
`example_basic_selector.php`	Example	Example script
`example_extract_data_attribute.php`	Example	Example script
`example_extract_html.php`	Example	Example script
`example_extract_meta_tags.php`	Example	Example script
`example_find_image_if_exists.php`	Example	Example script
`example_find_text.php`	Example	Example script
`example_modify_attribute.php`	Example	Example script
`example_modify_contents.php`	Example	Example script
`example_modify_styles_with_svg.php`	Example	Example script
`example_remove_comments.php`	Example	Example script
`example_remove_content.php`	Example	Example script
`example_remove_content_from_table.php`	Example	Example script
`example_scraping_imdb.php`	Example	Example script
`example_scraping_lebensmittelwarnung.php`	Example	Example script

Files (89)

src

File	Role	Description
`voku` (1 directory)

Files (89)

src

voku

File	Role	Description
`helper` (24 files)

Files (89)

src

voku

helper

File	Role	Description
`AbstractDomParser.php`	Class	Class source
`AbstractSimpleHtmlDom.php`	Class	Class source
`AbstractSimpleHtmlDomNode.php`	Class	Class source
`AbstractSimpleXmlDom.php`	Class	Class source
`AbstractSimpleXmlDomNode.php`	Class	Class source
`DomParserInterface.php`	Class	Class source
`HtmlDomHelper.php`	Class	Class source
`HtmlDomParser.php`	Class	Class source
`SelectorConverter.php`	Class	Class source
`SimpleHtmlAttributes.php`	Class	Class source
`SimpleHtmlAttributesInterface.php`	Class	Class source
`SimpleHtmlDom.php`	Class	Class source
`SimpleHtmlDomBlank.php`	Class	Class source
`SimpleHtmlDomInterface.php`	Class	Class source
`SimpleHtmlDomNode.php`	Class	Class source
`SimpleHtmlDomNodeBlank.php`	Class	Class source
`SimpleHtmlDomNodeInterface.php`	Class	Class source
`SimpleXmlDom.php`	Class	Class source
`SimpleXmlDomBlank.php`	Class	Class source
`SimpleXmlDomInterface.php`	Class	Class source
`SimpleXmlDomNode.php`	Class	Class source
`SimpleXmlDomNodeBlank.php`	Class	Class source
`SimpleXmlDomNodeInterface.php`	Class	Class source
`XmlDomParser.php`	Class	Class source

Files (89)

tests

File	Role	Description
`fixtures` (18 files)
`AuxiliarFunctionsTest.php`	Class	Class source
`bootstrap.php`	Aux.	Auxiliary script
`CommentTest.php`	Class	Class source
`DomManipulationTest.php`	Class	Class source
`HTML5DOMDocumentTest.php`	Class	Class source
`HtmlDomParserTest.php`	Class	Class source
`SimpleHtmlDomMemoryTest.php`	Class	Class source
`SimpleHtmlDomNodeTest.php`	Class	Class source
`SimpleHtmlDomTest.php`	Class	Class source
`SimpleHtmlHelperTest.php`	Class	Class source
`TwigTest.php`	Class	Class source
`XmlDomParserTest.php`	Class	Class source

Files (89)

tests

fixtures

File	Role	Description
`big.html`	Doc.	Documentation
`horrible.html`	Doc.	Documentation
`issue81.html`	Doc.	Documentation
`issue81_v2.html`	Doc.	Documentation
`small.html`	Doc.	Documentation
`test_mail.html`	Doc.	Documentation
`test_mail_expected.html`	Doc.	Documentation
`test_page.html`	Doc.	Documentation
`test_page_plaintext.html`	Doc.	Documentation
`test_template.twig`	Data	Auxiliary data
`test_template_js.html`	Doc.	Documentation
`test_xml.xml`	Data	Auxiliary data
`test_xml_complex.xml`	Data	Auxiliary data
`test_xml_complex_v2.xml`	Data	Auxiliary data
`test_xml_complex_v3.xml`	Example	Example script
`test_xml_expected.xml`	Data	Auxiliary data
`test_xml_replace_expected.xml`	Data	Auxiliary data
`windows-1252-example.html`	Doc.	Documentation

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.

Install with Composer

	voku-simple_html_dom-2025-05-07.zip
	voku-simple_html_dom-2025-05-07.tar.gz
	Install with Composer

Needed packages

Class	Download	Why it is needed	Dependency
Portable UTF-8	.zip .tar.gz	Strin	Required

Version Control

Reuses

Unique User Downloads

Download Rankings

100%

Total:	488
This week:	0

All time:	5,894
This week:	488

User Ratings

User Comments (1)

	All time
Utility:	93%
Consistency:	100%
Documentation:	93%
Examples:	93%
Tests:	-
Videos:	-
Overall:	75%
Rank:	72

nice
8 years ago (muabshir)

80%

Applications that use this package

No pages of applications that use this class were specified.

If you know an application of this package, send a message to the author to add a link here.

Other classes that need this package

Class	Why it is needed	Dependency
PHP CSS to Inline Styles	Dom-Manipulation	Required
PHP HTML Form Validator	HTML-Dom interactions	Required
PHP HTML Minify Class	Dom-Parsing	Required
PHP httpful Request	auto-parsing html output	Required

About us

Advertise on this site

For more information send a message to info at phpclasses dot org.