Modern DOM library written in PHP for HTML documents
| lib | ||
| tests | ||
| vendor-bin | ||
| .gitattributes | ||
| .gitignore | ||
| AUTHORS | ||
| composer.json | ||
| composer.lock | ||
| LICENSE | ||
| README.md | ||
| robo | ||
| robo.bat | ||
| RoboFile.php | ||
HTML5
Tools for parsing and printing HTML5 documents and fragments.
<?php
$dom = dW\HTML5\Parser::parse('<!DOCTYPE html><html lang="en" charset="utf-8"><head><title>Ook!</title></head><body><h1>Ook!</h1><p>Ook-ook? Oooook. Ook ook oook ook oooooook ook ooook ook.</p><p>Eek!</p></body></html>');
?>
or:
<?php
$dom = new dW\HTML5\Document;
$dom->loadHTML('<!DOCTYPE html><html lang="en" charset="utf-8"><head><title>Ook!</title></head><body><h1>Ook!</h1><p>Ook-ook? Oooook. Ook ook oook ook oooooook ook ooook ook.</p><p>Eek!</p></body></html>');
?>
Comparison with masterminds/html5
This library and masterminds/html5 serve similar purposes. Generally, we are more accurate, but they are much faster. The following table summarizes the main functional differences.
| Masterminds | MensBeam | |
|---|---|---|
| Minimum PHP version | 5.3 | 7.1 |
| Extensions required | dom, ctype, mbstring or iconv | dom |
| Supported encodings | System-dependent | Per specification |
| Encoding detection | None | Byte order mark, HTTP header, pre-scan |
| Fallback encoding | UTF-8, configurable | Windows-1252, configurable |
| Handling of invalid characters | Characters are dropped | Per specification |
| Handling of invalid XML element names | Name is changed to "invalid" | Per specification |
| Handling of invalid XML attribute names | Attribute is dropped | Per specification |
| Handling of misnested tags | Parent end tags always close children | Per specification |
| Handling of data between table cells | Left as-is | Per specification |
| Handling of omitted start tags | Elements are not inserted | Per specification |
| Handling of processing instructions | Processing instructions are retained | Per specification |
| Handling of bogus XLink namespace* | XLink attributes are lost if preceded by bogus namespace | Bogus namespace is ignored |
| Namespace for HTML elements | Per specification, configurable | Null |
| Time needed to parse single-page HTML specification | 2.7 seconds† | 6.2 seconds‡ |
| Peak memory needed for same | 38 MB | 13.9 MB |
* For example: <svg xmlns:xlink='http://www.w3.org/1999/xhtml' xlink:href='http://example.com/'/>. It is unclear what correct behaviour is, but we believe our behaviour to be more consistent with the intent of the specification.
† With HTML namespace disabled. With HTML namespace enabled it does not finish in a reasonable time due to a PHP bug.
‡ With parse errors suppressed. Reporting parse errors adds approximately 10% overhead.