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

olamedia / nokogiri

Maintainers

Details