<?php
namespace Safe;
use Safe\Exceptions\SimplexmlException;
/**
* This function takes a node of a DOM
* document and makes it into a SimpleXML node. This new object can
* then be used as a native SimpleXML element.
*
* @param \DOMNode $node A DOM Element node
* @param string $class_name You may use this optional parameter so that
* simplexml_import_dom will return an object of
* the specified class. That class should extend the
* SimpleXMLElement class.
* @return \SimpleXMLElement Returns a SimpleXMLElement.
* @throws SimplexmlException
*
*/
function simplexml_import_dom(\DOMNode $node, string $class_name = "SimpleXMLElement"): \SimpleXMLElement
{
error_clear_last();
$result = \simplexml_import_dom($node, $class_name);
if ($result === false) {
throw SimplexmlException::createFromPhpError();
}
return $result;
}
/**
* Convert the well-formed XML document in the given file to an object.
*
* @param string $filename Path to the XML file
*
* Libxml 2 unescapes the URI, so if you want to pass e.g.
* b&c as the URI parameter a,
* you have to call
* simplexml_load_file(rawurlencode('http://example.com/?a=' .
* urlencode('b&c'))). Since PHP 5.1.0 you don't need to do
* this because PHP will do it for you.
* @param string $class_name You may use this optional parameter so that
* simplexml_load_file will return an object of
* the specified class. That class should extend the
* SimpleXMLElement class.
* @param int $options Since PHP 5.1.0 and Libxml 2.6.0, you may also use the
* options parameter to specify additional Libxml parameters.
* @param string $ns Namespace prefix or URI.
* @param bool $is_prefix TRUE if ns is a prefix, FALSE if it's a URI;
* defaults to FALSE.
* @return \SimpleXMLElement Returns an object of class SimpleXMLElement with
* properties containing the data held within the XML document.
* @throws SimplexmlException
*
*/
function simplexml_load_file(string $filename, string $class_name = "SimpleXMLElement", int $options = 0, string $ns = "", bool $is_prefix = false): \SimpleXMLElement
{
error_clear_last();
$result = \simplexml_load_file($filename, $class_name, $options, $ns, $is_prefix);
if ($result === false) {
throw SimplexmlException::createFromPhpError();
}
return $result;
}
/**
* Takes a well-formed XML string and returns it as an object.
*
* @param string $data A well-formed XML string
* @param string $class_name You may use this optional parameter so that
* simplexml_load_string will return an object of
* the specified class. That class should extend the
* SimpleXMLElement class.
* @param int $options Since PHP 5.1.0 and Libxml 2.6.0, you may also use the
* options parameter to specify additional Libxml parameters.
* @param string $ns Namespace prefix or URI.
* @param bool $is_prefix TRUE if ns is a prefix, FALSE if it's a URI;
* defaults to FALSE.
* @return \SimpleXMLElement Returns an object of class SimpleXMLElement with
* properties containing the data held within the xml document.
* @throws SimplexmlException
*
*/
function simplexml_load_string(string $data, string $class_name = "SimpleXMLElement", int $options = 0, string $ns = "", bool $is_prefix = false): \SimpleXMLElement
{
error_clear_last();
$result = \simplexml_load_string($data, $class_name, $options, $ns, $is_prefix);
if ($result === false) {
throw SimplexmlException::createFromPhpError();
}
return $result;
}