MensBeam
/
HTML-Parser
3
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
A modern, accurate HTML parser and serializer for PHP
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
189 Commits
5 Branches
9 Tags
1.5 MiB
Tree: 3deddbddf3
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '3deddbddf3'
${ noResults }
HTML-Parser/README.md

39 lines
3.4 KiB
Raw Normal View History

Rewrote DOM Tools • Discovered a way to extend the existing DOM tools, so Parser now works with custom classes for the DOM. • \dW\HTML5\DOM is no longer needed, and its functionality has been split between DOM\Document and DOM\Element. • Printer's functionality is now handled by DOM\Document\saveHTML through a trait to make maintenance easier. • Normalized Exception constants. • Fixed various typing bugs.
6 years ago
# HTML5
Initial commit.
7 years ago
Rewrote DOM Tools • Discovered a way to extend the existing DOM tools, so Parser now works with custom classes for the DOM. • \dW\HTML5\DOM is no longer needed, and its functionality has been split between DOM\Document and DOM\Element. • Printer's functionality is now handled by DOM\Document\saveHTML through a trait to make maintenance easier. • Normalized Exception constants. • Fixed various typing bugs.
6 years ago
Tools for parsing and printing HTML5 documents and fragments.
Have Parser destroy its instance when finished • Getting ready to work on fragment parsing, simplifying Parser::parseFragment. • Added short example in README
6 years ago
```php
<?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>');
?>
Added additional entry point • Added an option to use Document::loadHTML or Document::load to parse a document. • Made the DOM elements use dW\HTML5 namespace instead of dW\HTML5\DOM. • Fixed where TreeBuilder wasn't being properly destructed when the parser is finished.
6 years ago
```
or:
```php
<?php
Organization • Moved the ancestor and descendant methods into their own traits along with the compare method which they share. • Made DocumentFragment use only the descendant methods and not the ancestor ones. • Fixed error in README.
6 years ago
$dom = new dW\HTML5\Document;
Added additional entry point • Added an option to use Document::loadHTML or Document::load to parse a document. • Made the DOM elements use dW\HTML5 namespace instead of dW\HTML5\DOM. • Fixed where TreeBuilder wasn't being properly destructed when the parser is finished.
6 years ago
$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>');
?>
```
Add draft comparison table
3 years ago
## Comparison with `masterminds/html5`
This library and [masterminds/html5](https://packagist.org/packages/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 |
|-----------------------------------------------------|---------------------------------------|----------------------------------------|
| Extensions required | dom, ctype, mbstring or iconv | dom |
More comparison items
3 years ago
| Supported encodings | System-dependent | [Per specification](https://html.spec.whatwg.org/multipage/parsing.html#character-encodings) |
| Encoding detection | None | Byte order mark, HTTP header, [pre-scan](https://html.spec.whatwg.org/multipage/parsing.html#prescan-a-byte-stream-to-determine-its-encoding) |
| Fallback encoding | UTF-8, configurable | Windows-1252, configurable |
Add draft comparison table
3 years ago
| Handling of invalid characters | Characters are dropped | [Per specification](https://encoding.spec.whatwg.org/#concept-encoding-process) |
| Handling of invalid XML element names | Name is changed to "invalid" | [Per specification](https://html.spec.whatwg.org/multipage/parsing.html#coercing-an-html-dom-into-an-infoset) |
| Handling of invalid XML attribute names | Attribute is dropped | [Per specification](https://html.spec.whatwg.org/multipage/parsing.html#coercing-an-html-dom-into-an-infoset) |
| Handling of misnested tags | Parent end tags always close children | [Per specification](https://html.spec.whatwg.org/multipage/parsing.html#an-introduction-to-error-handling-and-strange-cases-in-the-parser) |
| Handling of data between table cells | Left as-is | [Per specification](https://html.spec.whatwg.org/multipage/parsing.html#an-introduction-to-error-handling-and-strange-cases-in-the-parser) |
| Handling of omitted start tags | Elements are not inserted | Per specification |
More comparison items
3 years ago
| Handling of processing instructions | Processing instructions are retained | Per specification |
Add draft comparison table
3 years ago
| Time needed to parse single-page HTML specification | 2.8 seconds | 7.0 seconds |
| Peak memory needed for same | 38 MB | 13.9 MB |