REDROOM

Navigation

Breadcrumbs

Create

Edit File Size: 1.66 KB

//proc/self/root/home/getspomw/itechservicellc.com/vendor/masterminds/html5/src/HTML5/Parser/README.md

Text Base64

# The Parser Model

The parser model here follows the model in section
[8.2.1](http://www.w3.org/TR/2012/CR-html5-20121217/syntax.html#parsing)
of the HTML5 specification, though we do not assume a networking layer.

[ InputStream ]    // Generic support for reading input.
           ||
      [ Scanner ]       // Breaks down the stream into characters.
           ||
     [ Tokenizer ]      // Groups characters into syntactic
           ||
    [ Tree Builder ]    // Organizes units into a tree of objects
           ||
     [ DOM Document ]     // The final state of the parsed document.

## InputStream

This is an interface with at least two concrete implementations:

- StringInputStream: Reads an HTML5 string.
- FileInputStream: Reads an HTML5 file.

## Scanner

This is a mechanical piece of the parser.

## Tokenizer

This follows section 8.4 of the HTML5 spec. It is (roughly) a recursive
descent parser. (Though there are plenty of optimizations that are less
than purely functional.

## EventHandler and DOMTree

EventHandler is the interface for tree builders. Since not all
implementations will necessarily build trees, we've chosen a more
generic name.

The event handler emits tokens during tokenization.

The DOMTree is an event handler that builds a DOM tree. The output of
the DOMTree builder is a DOMDocument.

## DOMDocument

PHP has a DOMDocument class built-in (technically, it's part of libxml.)
We use that, thus rendering the output of this process compatible with
SimpleXML, QueryPath, and many other XML/HTML processing tools.

For cases where the HTML5 is a fragment of a HTML5 document a
DOMDocumentFragment is returned instead. This is another built-in class.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
CharacterReference.php	1.50 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
DOMTreeBuilder.php	22.83 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
EventHandler.php	3.59 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
FileInputStream.php	1.13 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
InputStream.php	2.44 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
ParseError.php	130 B	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
README.md	1.66 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
Scanner.php	11.19 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
StringInputStream.php	9.45 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
Tokenizer.php	35.68 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
TreeBuildingRules.php	3.20 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive
UTF8Utils.php	7.11 KB	lrw-r--r--	2025-10-28 20:22:44	Edit Download recursive recursive

Directory Contents