SimpleXMLElement::__construct
(PHP 5 >= 5.0.1, PHP 7)
SimpleXMLElement::__construct — Создание нового SimpleXMLElement объекта
Описание
$data
[, int $options = 0
[, bool $data_is_url = false
[, string $ns = ""
[, bool $is_prefix = false
]]]] )Создает новый SimpleXMLElement объект.
Список параметров
-
data -
Правильно сформированная XML строка. Может быть путем или URL к XML документу, если параметр
data_is_urlустановлен вTRUE. -
options -
Необязательный параметр, используется для указания дополнительных параметров Libxml.
-
data_is_url -
По умолчанию,
data_is_urlустановлен вFALSE. ИспользуйтеTRUEдля указания того, чтоdataявляется путем или URL к XML документу вместо string данных. -
ns -
Префикс пространства имен или URI.
-
is_prefix -
TRUEеслиnsявляется префиксом,FALSEесли это URI; по умолчаниюFALSE.
Возвращаемые значения
Возвращает объект SimpleXMLElement представляющий
data.
Ошибки
Выдает сообщение с ошибкой E_WARNING для каждой найденной
ошибки в XML данных, и дополнительно генерирует исключение Exception,
если XML данные не могут быть разобраны.
Используйте libxml_use_internal_errors() для подавления всех XML ошибок, и libxml_get_errors() для их переборки.
Примеры
Замечание:
Перечисленные примеры могут включать example.php, в котором определяется XML строка, расположенная в первом примере руководства по базовому использованию.
Пример #1 Создание объекта SimpleXMLElement
<?php
include 'example.php';
$sxe = new SimpleXMLElement($xmlstr);
echo $sxe->movie[0]->title;
?>
Результат выполнения данного примера:
PHP: Появление Парсера
Пример #2 Создание объекта SimpleXMLElement из URL
<?php
$sxe = new SimpleXMLElement('http://example.org/document.xml', NULL, TRUE);
echo $sxe->asXML();
?>
Список изменений
| Версия | Описание |
|---|---|
| 5.2.0 | Добавлены параметры ns и is_prefix. |
| 5.1.2 | Добавлены параметры options и data_is_url. |
Смотрите также
- Базовое использование SimpleXML
- simplexml_load_string() - Интерпретирует строку с XML в объект
- simplexml_load_file() - Интерпретирует XML-файл в объект
- Работа с ошибками XML
- libxml_use_internal_errors() - Отключение ошибок libxml и передача полномочий по выборке и обработке информации об ошибках пользователю
- Функция SimpleXMLElement::addAttribute() - Добавляет атрибут к SimpleXML-элементу
- Функция SimpleXMLElement::addChild() - Добавляет дочерний элемент к узлу XML
- Функция SimpleXMLElement::asXML() - Возвращает сформированный XML документ в виде строки используя SimpleXML элемент
- Функция SimpleXMLElement::attributes() - Возвращает атрибуты элемента
- Функция SimpleXMLElement::children() - Поиск дочерних элементов данного узла
- Функция SimpleXMLElement::__construct() - Создание нового SimpleXMLElement объекта
- Функция SimpleXMLElement::count() - Считает количество дочерних элементов у текущего элемента
- Функция SimpleXMLElement::getDocNamespaces() - Возвращает объявленное пространство имен в документе
- Функция SimpleXMLElement::getName() - Получение имени XML элемента
- Функция SimpleXMLElement::getNamespaces() - Получение пространств имен, используемых в документе
- Функция SimpleXMLElement::registerXPathNamespace() - Создает префикс/пространство имен контекста для следующего XPath запроса
- Функция SimpleXMLElement::saveXML() - Псевдоним SimpleXMLElement::asXML
- Функция SimpleXMLElement::__toString() - Returns the string content
- Функция SimpleXMLElement::xpath() - Запускает XPath запрос к XML данным
Коментарии
This class is extendable, but it's too bad that its constructor cannot be overriden (PHP says it's a final method). Thus the class should be wrapped using the delegation principle rather that extended.As I was filling out a bug report, I realized why (speculation here) the constructor is final: so that functions like simplexml_load_file and simplexml_load_string can work. I imagine the PHP-ized code looks something like
<?php
function simplexml_load_file($filename, $class_name = "SimpleXMLElement", $options = 0, $ns = "", $is_prefix = false) {
return new $class_name($filename, $options, true, $ns, $is_prefix);
}
?>
If we were to use a different $class_name and change the constructor's definition these functions wouldn't work.
There's no easy, sensible solution that keeps simplexml_load_file and simplexml_load_string.
Using libxml_use_internal_errors() may suppress errors but Exception still requires decent handling. I used following code snippet.
<?php
libxml_use_internal_errors(true);
try{
$xmlToObject = new SimpleXMLElement($notSoWellFormedXML);
} catch (Exception $e){
echo 'Please try again later...';
exit();
}
?>
It's worth noting that the behavior of SimpleXmlElement::__construct is not exactly the same as simplexml_load_string, regarding libxml_use_internal_errors().
In my case,
<?php
libxml_use_internal_errors(true);
new \SimpleXmlElement($data);
?>
was still throwing error. But as soon as I switched to
<?php
libxml_use_internal_errors(true);
simplexml_load_string($data);
?>
everything worked fine and I stopped getting an error.
You won't be able to load an XML file without root element:
//This will throw an exception
$xml = new SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?>', null, false);
//Here is the solution
$xml = new SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?><root></root>', null, false);
The manual doesn't really explain what the $ns argument (and the accompanying $is_prefix) are for.
What they do is similar to the ->children() method: they set the context of the returned object to that namespace, so that access via ->elementName and ['attributeName'] refer to elements and attributes in that namespace.
In particular, they do *not* change the namespaces which exist on the document.
See this example:
<?php
// This XML contains two elements called <child>
// One is in the namespace http://example.com, with local prefix 'ws'
// The other has no namespace (no prefix, and no default namespace declared)
$xml = '<ws:example xmlns:ws="http://example.com"><child>Not in namespace</child><ws:child>In example namespace</ws:child></ws:example>';
$sx0 = new SimpleXMLElement($xml, 0, false);
$sx1 = new SimpleXMLElement($xml, 0, false, 'http://example.com');
$sx2 = new SimpleXMLElement($xml, 0, false, 'ws', true);
echo "
Without: {$sx0->child}
By namespace: {$sx1->child}
By prefix: {$sx2->child}
";
?>
Output:
Without: Not in namespace
By namespace: In example namespace
By prefix: In example namespace
Extended SimpleXMLElement:
<?php
class XmlElement extends \SimpleXMLElement
{
public static function factory(string $root): self
{
return new static('<?xml version="1.0" encoding="UTF-8"?><'.$root.'/>', LIBXML_BIGLINES | LIBXML_COMPACT);
}
/**
* @param iterable $attributes An array of element attributes as name/value pairs
* @return $this
*/
public function addAttributes(iterable $attributes)
{
foreach ($attributes as $name => $value) {
$this->addAttribute($name, $value);
}
return $this;
}
/**
* @param string $name The sub-element name
* @param string|array|null $valueOrAttributes The sub-element value or an array of attributes
* @param string|null $namespace The sub-element namespace
* @return static|null
*/
public function addChild($name, $valueOrAttributes = null, $namespace = null)
{
if (is_array($valueOrAttributes)) {
$child = parent::addChild($name, null, $namespace);
foreach ($valueOrAttributes as $name => $value) {
$child->addAttribute($name, $value);
}
} else {
$child = parent::addChild($name, $valueOrAttributes, $namespace);
}
return $child;
}
/**
* @param iterable $childs An array of sub-elements as name/value(or attributes) pairs
* @return $this
*/
public function addChilds(iterable $childs)
{
foreach ($childs as $name => $value) {
$this->addChild($name, $value);
}
return $this;
}
}
?>