Класс DOMDocument DOMDocument
&reftitle.intro; Представляет весь HTML- или XML-документ; корень дерева документа.
&reftitle.classsynopsis; DOMDocument extends DOMNode implements DOMParentNode &Properties; public readonly DOMDocumentTypenull doctype public readonly DOMImplementation implementation public readonly DOMElementnull documentElement public readonly stringnull actualEncoding public stringnull encoding public readonly stringnull xmlEncoding public bool standalone public bool xmlStandalone public stringnull version public stringnull xmlVersion public bool strictErrorChecking public stringnull documentURI public readonly mixed config public bool formatOutput public bool validateOnParse public bool resolveExternals public bool preserveWhiteSpace public bool recover public bool substituteEntities public readonly DOMElementnull firstElementChild public readonly DOMElementnull lastElementChild public readonly int childElementCount &InheritedProperties; &Methods; &InheritedMethods;
&reftitle.properties; actualEncoding Устарело. Кодировка документа — доступный только для чтения эквивалент свойства encoding. childElementCount Количество дочерних элементов. config Устарело. Конфигурация, которая будет использована при вызове метода DOMDocument::normalizeDocument. doctype Объявление типа документа, которое соответствует этому документу. documentElement Объект DOMElement — первый элемент документа. Если не найден, оценивается как &null;. Удобный атрибут, который даёт прямой доступ к дочернему узлу как к элементу документа. Значение &null;, если не существует. documentURI Расположение документа или &null;, если оно не определено. encoding Кодировка документа, как указано в объявлении XML. Этого атрибута нет в последней спецификации DOM Level 3, но он — единственный способ манипулирования кодировкой XML-документа в этой реализации. firstElementChild Первый дочерний элемент или &null;. formatOutput Форматирует вывод, добавляя отступы и дополнительные пробелы. Не работает, если документ был загружен с включённым свойством preserveWhitespace. implementation Объект класса DOMImplementation, обрабатывающий этот документ. lastElementChild Последний дочерний элемент или &null;. preserveWhiteSpace Указание не убирать лишние пробелы и отступы. По умолчанию &true;. Установка этого значения в &false; даёт тот же эффект, что и передача константы LIBXML_NOBLANKS в качестве параметра option в метод DOMDocument::load и т. д. recover Проприетарное свойство. Включает режим восстановления, то есть пытается разобрать некорректно составленные (non-well formed) документы. Этот атрибут не входит в спецификацию DOM и специфичен для модуля libxml. resolveExternals Устанавливают в &true; для загрузки внешних элементов из объявления типа документа. Полезен при включении элементов с символьными данными в XML-документ. standalone Устарело. Указание, что документ не зависит от других XML-документов, как указано в декларации XML, соответствует свойству xmlStandalone. strictErrorChecking Выбрасывает исключение DOMException в случае ошибок. По умолчанию &true;. substituteEntities Патентованное свойство. Указывает, заменять ли элементы документа. Этот атрибут не входит в спецификацию DOM и специфичен для модуля libxml. По умолчанию &false;. Включение подмены сущностей способствует атакам XML External Entity (XXE). validateOnParse Загружает DTD и проверяет документ на соответствие. По умолчанию &false;. Включение проверки DTD способствует атакам XML External Entity (XXE). version Устарело. Версия XML, соответствует xmlVersion. xmlEncoding Атрибут, который определяет, как часть XML-объявления, кодировку документа. Значение равно &null;, если его не указали, или когда значение неизвестно, например, когда документ создали в памяти. xmlStandalone Атрибут, который определяет, как часть XML-объявления, что документ автономный. Принимает значение &false;, если не указан. Автономный документ — документ, в котором отсутствуют объявления внешней разметки. Пример такого объявления разметки — объявление в типе документа DTD атрибута со значением по умолчанию. xmlVersion Атрибут, который определяет, как часть XML-объявления, номер версии этого документа. Если объявления в документе нет, но есть поддержка всех особенностей «XML», значение равно «1.0».
&reftitle.changelog; &Version; &Description; 8.0.0 Класс DOMDocument теперь реализует интерфейс DOMParentNode. 8.0.0 Нереализованный метод DOMDocument::renameNode был удалён.
&reftitle.notes; &dom.note.utf8; &dom.note.json;
&reftitle.seealso; Спецификация W3C для интерфейса Document
&reference.dom.entities.domdocument;