Download the PHP package natlibfi/php-html-parser without Composer
On this page you can find all versions of the php package natlibfi/php-html-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download natlibfi/php-html-parser
More information about natlibfi/php-html-parser
Files in natlibfi/php-html-parser
Package php-html-parser
Short Description An HTML DOM parser. It allows you to manipulate HTML. Find tags on an HTML page with selectors just like jQuery.
License MIT
Homepage https://github.com/NatLibFi/php-html-parser
Informations about the package php-html-parser
PHP Html Parser
Forked from paquettg/php-html-parser
PHPHtmlParser is a simple, flexible, html parser which allows you to select tags using any css selector, like jQuery. The goal is to assist in the development of tools which require a quick, easy way to scrap html, whether it's valid or not!
Install
Install the latest version using composer.
This package can be found on packagist and is best loaded using composer. We support php 7.4, 8.0 and 8.1.
Basic Usage
You can find many examples of how to use the DOM parser and any of its parts (which you will most likely never touch) in the tests directory. The tests are done using PHPUnit and are very small, a few lines each, and are a great place to start. Given that, I'll still be showing a few examples of how the package should be used. The following example is a very simplistic usage of the package.
The above will output "click here". Simple, no? There are many ways to get the same result from the DOM, such as $dom->getElementsbyTag('a')[0]
or $dom->find('a', 0)
, which can all be found in the tests or in the code itself.
Loading Files
You may also seamlessly load a file into the DOM instead of a string, which is much more convenient and is how I expect most developers will be loading the HTML. The following example is taken from our test and uses the "big.html" file found there.
This example loads the html from big.html, a real page found online, and gets all the content-border classes to process. It also shows a few things you can do with a node but it is not an exhaustive list of the methods that a node has available.
Loading URLs
Loading a URL is very similar to the way you would load the HTML from a file.
loadFromUrl will, by default, use an implementation of the \Psr\Http\Client\ClientInterface
to do the HTTP request and a default implementation of \Psr\Http\Message\RequestInterface
to create the body of the request. You can easily implement your own version of either the client or request to use a custom HTTP connection when using loadFromUrl.
As long as the client object implements the interface properly, it will use that object to get the content of the url.
Loading Strings
Loading a string directly is also easily done.
Options
You can also set parsing option that will effect the behavior of the parsing engine. You can set a global option array using the setOptions
method in the Dom
object or a instance specific option by adding it to the load
method as an extra (optional) parameter.
At the moment we support 12 options.
Strict
Strict, by default false, will throw a StrickException
if it find that the html is not strictly compliant (all tags must have a closing tag, no attribute with out a value, etc.).
whitespaceTextNode
The whitespaceTextNode, by default true, option tells the parser to save textnodes even if the content of the node is empty (only whitespace). Setting it to false will ignore all whitespace only text node found in the document.
enforceEncoding
The enforceEncoding, by default null, option will enforce an character set to be used for reading the content and returning the content in that encoding. Setting it to null will trigger an attempt to figure out the encoding from within the content of the string given instead.
cleanupInput
Set this to false
to skip the entire clean up phase of the parser. If this is set to true the next 3 options will be ignored. Defaults to true
.
removeScripts
Set this to false
to skip removing the script tags from the document body. This might have adverse effects. Defaults to true
.
removeStyles
Set this to false
to skip removing of style tags from the document body. This might have adverse effects. Defaults to true
.
preserveLineBreaks
Preserves Line Breaks if set to true
. If set to false
line breaks are cleaned up as part of the input clean up process. Defaults to false
.
removeDoubleSpace
Set this to false
if you want to preserve whitespace inside of text nodes. It is set to true
by default.
removeSmartyScripts
Set this to false
if you want to preserve smarty script found in the html content. It is set to true
by default.
htmlSpecialCharsDecode
By default this is set to false
. Setting this to true
will apply the php function htmlspecialchars_decode
too all attribute values and text nodes.
selfClosing
This option contains an array of all self closing tags. These tags must be self closing and the parser will force them to be so if you have strict turned on. You can update this list with any additional tags that can be used as a self closing tag when using strict. You can also remove tags from this array or clear it out completly.
noSlash
This option contains an array of all tags that can not be self closing. The list starts off as empty but you can add elements as you wish.
Static Facade
You can also mount a static facade for the Dom object.
The above php block does the same find and load as the first example but it is done using the static facade, which supports all public methods found in the Dom object.
Modifying The Dom
You can always modify the dom that was created from any loading method. To change the attribute of any node you can just call the setAttribute
method.
You may also get the PHPHtmlParser\Dom\Tag
class directly and manipulate it as you see fit.
It is also possible to remove a node from the tree. Simply call the delete
method on any node to remove it from the tree. It is important to note that you should unset the node after removing it from the `DOM``, it will still take memory as long as it is not unset.
You can modify the text of TextNode
objects easily. Please note that, if you set an encoding, the new text will be encoded using the existing encoding.
All versions of php-html-parser with dependencies
ext-mbstring Version *
ext-zlib Version *
ext-curl Version *
paquettg/string-encode Version ~1.0.0
php-http/httplug Version ^2.3.0
guzzlehttp/guzzle Version ^7.5.0
guzzlehttp/psr7 Version ^2.4.1
myclabs/php-enum Version ^1.8.4