| Server IP : 66.29.137.217 / Your IP : 3.144.254.237 Web Server : LiteSpeed System : Linux premium294.web-hosting.com 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64 User : gltevjme ( 1095) PHP Version : 7.0.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /home/gltevjme/cbt.bofirm.com/vendor/paquettg/php-html-parser/src/PHPHtmlParser/ |
Upload File : |
<?php
declare(strict_types=1);
namespace PHPHtmlParser;
use GuzzleHttp\Psr7\Request;
use GuzzleHttp\Client;
use PHPHtmlParser\Contracts\Dom\CleanerInterface;
use PHPHtmlParser\Contracts\Dom\ParserInterface;
use PHPHtmlParser\Contracts\DomInterface;
use PHPHtmlParser\Discovery\CleanerDiscovery;
use PHPHtmlParser\Discovery\DomParserDiscovery;
use PHPHtmlParser\Dom\Node\Collection;
use PHPHtmlParser\Dom\RootAccessTrait;
use PHPHtmlParser\Exceptions\ChildNotFoundException;
use PHPHtmlParser\Exceptions\CircularException;
use PHPHtmlParser\Exceptions\LogicalException;
use PHPHtmlParser\Exceptions\NotLoadedException;
use PHPHtmlParser\Exceptions\StrictException;
use PHPHtmlParser\Exceptions\UnknownChildTypeException;
use Psr\Http\Client\ClientExceptionInterface;
use Psr\Http\Client\ClientInterface;
use Psr\Http\Message\RequestInterface;
/**
* Class Dom.
*/
class Dom implements DomInterface
{
use RootAccessTrait;
/**
* The charset we would like the output to be in.
*
* @var string
*/
private $defaultCharset = 'UTF-8';
/**
* The document string.
*
* @var Content
*/
private $content;
/**
* A global options array to be used by all load calls.
*
* @var ?Options
*/
private $globalOptions;
/**
* @var ParserInterface
*/
private $domParser;
/**
* @var CleanerInterface
*/
private $domCleaner;
public function __construct(?ParserInterface $domParser = null, ?CleanerInterface $domCleaner = null)
{
if ($domParser === null) {
$domParser = DomParserDiscovery::find();
}
if ($domCleaner === null) {
$domCleaner = CleanerDiscovery::find();
}
$this->domParser = $domParser;
$this->domCleaner = $domCleaner;
}
/**
* Returns the inner html of the root node.
*
* @throws ChildNotFoundException
* @throws UnknownChildTypeException
* @throws NotLoadedException
*/
public function __toString(): string
{
$this->isLoaded();
return $this->root->innerHtml();
}
/**
* Loads the dom from a document file/url.
*
* @throws ChildNotFoundException
* @throws CircularException
* @throws Exceptions\ContentLengthException
* @throws LogicalException
* @throws StrictException
*/
public function loadFromFile(string $file, ?Options $options = null): Dom
{
$content = @\file_get_contents($file);
if ($content === false) {
throw new LogicalException('file_get_contents failed and returned false when trying to read "' . $file . '".');
}
return $this->loadStr($content, $options);
}
/**
* Use a curl interface implementation to attempt to load
* the content from a url.
*
* @throws ChildNotFoundException
* @throws CircularException
* @throws Exceptions\ContentLengthException
* @throws LogicalException
* @throws StrictException
* @throws ClientExceptionInterface
*/
public function loadFromUrl(string $url, ?Options $options = null, ?ClientInterface $client = null, ?RequestInterface $request = null): Dom
{
if ($client === null) {
$client = new Client();
}
if ($request === null) {
$request = new Request('GET', $url);
}
$response = $client->sendRequest($request);
$content = $response->getBody()->getContents();
return $this->loadStr($content, $options);
}
/**
* Parsers the html of the given string. Used for load(), loadFromFile(),
* and loadFromUrl().
*
* @throws ChildNotFoundException
* @throws CircularException
* @throws Exceptions\ContentLengthException
* @throws LogicalException
* @throws StrictException
*/
public function loadStr(string $str, ?Options $options = null): Dom
{
$localOptions = new Options();
if ($this->globalOptions !== null) {
$localOptions = $localOptions->setFromOptions($this->globalOptions);
}
if ($options !== null) {
$localOptions = $localOptions->setFromOptions($options);
}
$html = $this->domCleaner->clean($str, $localOptions, $this->defaultCharset);
$this->content = new Content($html);
$this->root = $this->domParser->parse($localOptions, $this->content, \strlen($str));
$this->domParser->detectCharset($localOptions, $this->defaultCharset, $this->root);
return $this;
}
/**
* Sets a global options array to be used by all load calls.
*/
public function setOptions(Options $options): Dom
{
$this->globalOptions = $options;
return $this;
}
/**
* Find elements by css selector on the root node.
*
* @throws NotLoadedException
* @throws ChildNotFoundException
*
* @return mixed|Collection|null
*/
public function find(string $selector, int $nth = null)
{
$this->isLoaded();
return $this->root->find($selector, $nth);
}
/**
* Simple wrapper function that returns an element by the
* id.
*
* @param $id
*
* @throws NotLoadedException
* @throws ChildNotFoundException
*
* @return mixed|Collection|null
*/
public function getElementById($id)
{
$this->isLoaded();
return $this->find('#' . $id, 0);
}
/**
* Simple wrapper function that returns all elements by
* tag name.
*
* @throws NotLoadedException
* @throws ChildNotFoundException
*
* @return mixed|Collection|null
*/
public function getElementsByTag(string $name)
{
$this->isLoaded();
return $this->find($name);
}
/**
* Simple wrapper function that returns all elements by
* class name.
*
* @throws NotLoadedException
* @throws ChildNotFoundException
*
* @return mixed|Collection|null
*/
public function getElementsByClass(string $class)
{
$this->isLoaded();
return $this->find('.' . $class);
}
/**
* Checks if the load methods have been called.
*
* @throws NotLoadedException
*/
private function isLoaded(): void
{
if (\is_null($this->content)) {
throw new NotLoadedException('Content is not loaded!');
}
}
}