Server : Apache System : Linux server2.corals.io 4.18.0-348.2.1.el8_5.x86_64 #1 SMP Mon Nov 15 09:17:08 EST 2021 x86_64 User : corals ( 1002) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /home/corals/old/vendor/phpgt/dom/src/ |
<?php
namespace Gt\Dom;
use DOMAttr;
use DOMCharacterData;
use DOMComment;
use DOMDocument;
use DOMDocumentFragment;
use DOMDocumentType;
use DOMElement;
use DOMNode;
use DOMText;
use Psr\Http\Message\StreamInterface;
use RuntimeException;
/**
* Represents any web page loaded in the browser and serves as an entry point
* into the web page's content, the DOM tree (including elements such as
* <body> or <table>).
*
* @property-read DocumentType $doctype;
* @property-read Element $documentElement
* @property-read Document $ownerDocument
*
* @method Attr createAttribute(string $name)
* @method Comment createComment(string $data)
* @method DocumentFragment createDocumentFragment()
* @method Element createElement(string $name)
* @method Element createTextNode(string $content)
* @method ?Element getElementById(string $id)
*/
class Document extends DOMDocument implements StreamInterface {
use LiveProperty, ParentNode;
/** @var resource */
protected $stream;
/** @var ?int number of bytes filled */
protected $streamFilled;
public function __construct($document = null) {
libxml_use_internal_errors(true);
parent::__construct("1.0", "utf-8");
$this->registerNodeClass(DOMNode::class, Node::class);
$this->registerNodeClass(DOMElement::class, Element::class);
$this->registerNodeClass(DOMAttr::class, Attr::class);
$this->registerNodeClass(DOMDocumentFragment::class, DocumentFragment::class);
$this->registerNodeClass(DOMDocumentType::class, DocumentType::class);
$this->registerNodeClass(DOMCharacterData::class, CharacterData::class);
$this->registerNodeClass(DOMText::class, Text::class);
$this->registerNodeClass(DOMComment::class, Comment::class);
if($document instanceof DOMDocument) {
$node = $this->importNode($document->documentElement, true);
$this->appendChild($node);
return;
}
$this->stream = fopen("php://memory", "r+");
}
protected function getRootDocument():DOMDocument {
return $this;
}
public function __toString() {
return $this->saveHTML();
}
public function saveHTML(DOMNode $node = null):string {
if(is_null($this->streamFilled)) {
$this->fillStream();
}
else {
fseek($this->stream, $this->streamFilled);
}
return parent::saveHTML($node);
}
/**
* Closes the stream and any underlying resources.
*
* @return void
*/
public function close():void {
$this->stream = null;
}
/**
* Separates any underlying resources from the stream.
*
* After the stream has been detached, the stream is in an unusable state.
*
* @return resource|null Underlying PHP stream, if any
*/
public function detach() {
$this->fillStream();
$stream = $this->stream;
$this->stream = null;
return $stream;
}
/**
* Get the size of the stream if known.
*
* @return int|null Returns the size in bytes if known, or null if unknown.
*/
public function getSize() {
$this->fillStream();
return $this->streamFilled;
}
/**
* Returns the current position of the file read/write pointer
*
* @return int Position of the file pointer
* @throws RuntimeException on error.
*/
public function tell():int {
$tell = null;
if(!is_null($this->stream)) {
$tell = ftell($this->stream);
}
$this->fillStream();
if(!is_null($tell)) {
fseek($this->stream, $tell);
}
return $tell;
}
/**
* Returns true if the stream is at the end of the stream.
*
* @return bool
*/
public function eof() {
$this->fillStream();
return feof($this->stream);
}
/**
* Returns whether or not the stream is seekable.
*
* @return bool
*/
public function isSeekable() {
$this->fillStream();
return $this->getMetadata("seekable");
}
/**
* Seek to a position in the stream.
*
* @link http://www.php.net/manual/en/function.fseek.php
* @param int $offset Stream offset
* @param int $whence Specifies how the cursor position will be calculated
* based on the seek offset. Valid values are identical to the built-in
* PHP $whence values for `fseek()`. SEEK_SET: Set position equal to
* offset bytes SEEK_CUR: Set position to current location plus offset
* SEEK_END: Set position to end-of-stream plus offset.
* @throws RuntimeException on failure.
*/
public function seek($offset, $whence = SEEK_SET):void {
$this->fillStream();
$result = fseek($this->stream, $offset, $whence);
if($result === -1) {
throw new RuntimeException("Error seeking Document Stream");
}
}
/**
* Seek to the beginning of the stream.
*
* If the stream is not seekable, this method will raise an exception;
* otherwise, it will perform a seek(0).
*
* @throws RuntimeException on failure.
* @link http://www.php.net/manual/en/function.fseek.php
* @see seek()
*/
public function rewind():void {
$this->fillStream();
$this->seek(0);
}
/**
* Returns whether or not the stream is writable.
*
* @return bool
*/
public function isWritable():bool {
$this->fillStream();
$mode = $this->getMetadata("mode");
$writable = false;
if(strstr($mode, "w") || strstr($mode, "+") || strstr($mode, "a")) {
$writable = true;
}
return $writable;
}
/**
* Write data to the stream.
*
* @param string $string The string that is to be written.
* @return int Returns the number of bytes written to the stream.
* @throws RuntimeException on failure.
*/
public function write($string):int {
$this->fillStream();
$this->loadHTML($this->getContents() . $string);
$bytesWritten = fwrite($this->stream, $string);
return $bytesWritten;
}
/**
* Returns whether or not the stream is readable.
*
* @return bool
*/
public function isReadable():bool {
$this->fillStream();
$mode = $this->getMetadata("mode");
$readable = false;
if(strstr($mode, "r")
|| strstr($mode, "+")) {
$readable = true;
}
return $readable;
}
/**
* Read data from the stream.
*
* @param int $length Read up to $length bytes from the object and return
* them. Fewer than $length bytes may be returned if underlying stream
* call returns fewer bytes.
* @return string Returns the data read from the stream, or an empty string
* if no bytes are available.
* @throws RuntimeException if an error occurs.
*/
public function read($length):string {
$this->fillStream();
$bytesRead = fread($this->stream, $length);
return $bytesRead;
}
/**
* Returns the remaining contents in a string
*
* @return string
* @throws RuntimeException if unable to read or an error occurs while
* reading.
*/
public function getContents():string {
$this->fillStream();
if(!is_resource($this->stream)) {
throw new RuntimeException("Stream is not available");
}
$string = stream_get_contents($this->stream);
return $string;
}
/**
* Get stream metadata as an associative array or retrieve a specific key.
*
* The keys returned are identical to the keys returned from PHP's
* stream_get_meta_data() function.
*
* @link http://php.net/manual/en/function.stream-get-meta-data.php
* @param string $key Specific metadata to retrieve.
* @return array|mixed|null Returns an associative array if no key is
* provided. Returns a specific key value if a key is provided and the
* value is found, or null if the key is not found.
*/
public function getMetadata($key = null) {
$this->fillStream();
$metaData = stream_get_meta_data($this->stream);
if(is_null($key)) {
return $metaData;
}
return $metaData[$key] ?? null;
}
private function fillStream():void {
if(!is_null($this->streamFilled)) {
return;
}
if(!is_resource($this->stream)) {
throw new RuntimeException("Stream is closed");
}
$this->streamFilled = 0;
$this->streamFilled = fwrite($this->stream, $this->__toString());
fseek($this->stream, 0);
}
}