README

Attention: New version can break compatibility, in that case use previous version under the v1.0 branch or tag which supports even php 5.4+

\nokogiri class is left for compatibility

In English На русском

HTML parser

This library is a fast HTML parser, which can work with invalid code (errors are ignored).
Under the hood is used LibXML.
As the input you can use HTML string in UTF-8 encoding or DOMDocument.
For the querying elements CSS selectors are used, which are transformed to XPath expressions internally.

Usage

Loading HTML

HTML errors are ignored

• From HTML string $saw = new \nokogiri($html); $saw = \nokogiri::fromHtml($html);
• From DOM elements $saw = new \nokogiri($dom); $saw = \nokogiri::fromDom($dom);

get($cssSelector)

$cssSelector elements have the following format: tagName[attribute=value]#elementId.className:pseudoSelector(expression)

$saw->get('div > a[rel=bookmark]')->toArray();

toArray()

Returns underlying DOM structure as an array.
Values are attributes, text content under #text key and child elements under numeric keys

toXml()

Returns HTML string

getDom() toDom()

Returns DOMDocument. Given true as the first argument - can also return DOMNodeList or DOMElement

Iteration over found elements

foreach ($saw->get('#sidebar a.topic') as $link){
    var_dump($link['#text']);
}

Implemented selectors

• tag
• .class
• #id
• [attr]
• [attr=value]
• :root
• :empty
• :first-child
• :last-child
• :first-of-type
• :last-of-type
• :only-of-type
• :nth-child(a)
• :nth-child(an+b)
• :nth-child(even/odd)

Requirements

• DOM
• libxml >=2.9.0
• PHP >= 7.3

License

MIT

What's new

2.0.0

• Minimal PHP version 7.3
• Minimal LibXML version 2.9.0
• Complete refactoring
• Partially changed behaviour, can break compatibility
• HTML loading behaviour changed
• Test coverage
• Fixed work of nth-child and other selectors
• Incorrect selectors now throw exceptions
• New selectors added

1.0.0

• First version, 2011
• Minimal PHP version 5.4