Предупреждение!
Это расширение является ЭКСПЕРИМЕНТАЛЬНЫМ. Поведение этого расширения, имена его функций и всё, что задокументировано, может измениться в последующих релизах РНР без предупреждения. Вы предупреждены и можете использовать это расширение только под вашу ответственность.
Расширение domxml может быть переопределено в версии PHP 4.3.0 в пользу
лучшего соответствия стандарту DOM. В этом расширении всё ещё имеются
некоторые старые функции, но они более не должны использоваться. Особо нужно
исключить не-объектно-ориентированные функции.
Это расширение позволяет работать с XML-документами с помощью DOM API. Оно также предоставляет функцию
domxml_xmltree() DomDocument_dump_mem()
DomDocument_create_element()
DomDocument_create_text_node() set_attribute() , etc. и в конце -
DomDocument_dump_mem()
Это расширение использует
GNOME xml-библиотеки
Это расширение доступно, если PHP был сконфигурирован с опцией
--with-dom=[DIR] .
Имеются некоторые функции, которые не вписываются стандарт DOM и не должны
поэтому использоваться; они перечислены в следующей таблице. Функция
DomNode_append_child() DomNode_append_sibling()
Таблица 1. Не рекомендуемые функции и замены для них
Эти константы определены данным расширением и будут доступны только в том случае, если либо вкомпилированы в РНР, либо динамически загружены на этапе прогона.
Таблица 2. XML-константы
API этого модуля следует, насколько возможно, стандарту DOM Level 2.
Поэтому данный API является полностью объектно-ориентированным.
Хорошо было бы иметь доступ к стандарту DOM при использовании этого модуля.
Хотя данный API является объектно-ориентированным, имеется много функций,
которые можно вызывать не-объектно-ориентированным путём с помощью передачи
объекта, с которым работают, как первого аргумента. Эти функции в основном
предназначены для сохранения совместимости со старыми версиями расширения, но
больше не рекомендуются для использования в новых разработках.
Этот API отличается от официального DOM API двумя вещами. Во-первых, все
атрибуты класса реализованы как функции с тем же именем, а во-вторых - имена
функций следую соглашению PHP по именованию. Это значит, что DOM-функция lastChild() будет записана как last_child().
Этот модуль определяет несколько классов, которые перечислены -
включая их методы - в следующих таблицах. Классы с эквивалентом в DOM Standard именуются DOMxxx.
Таблица 3. Список классов Имя класса
Родительский класс DomAttribute DomNode DomCData
DomNode DomComment DomCData : DomNode DomDocument
DomNode DomDocumentType DomNode DomElement DomNode
DomEntity DomNode DomEntityReference DomNode
DomProcessingInstruction DomNode DomText DomCData : DomNode Parser Пока ещё называется DomParser XPathContext
Таблица 4. Класс DomDocument (DomDocument : DomNode)
Таблица 5. Класс DomElement (DomElement : DomNode)
Таблица 6. Класс DomNode Таблица 7. Класс DomAttribute (DomAttribute : DomNode)
Таблица 8. Класс DomProcessingInstruction (DomProcessingInstruction : DomNode)
Таблица 9. Класс Parser
Имя метода Имя функции Примечание add_chunk
Parser_add_chunk() end Parser_end()
Таблица 10. Класс XPathContext
Имя метода Имя функции Примечание
eval XPathContext_eval() eval_expression
XPathContext_eval_expression() register_ns
XPathContext_register_ns()
Таблица 11. Класс DomDocumentType (DomDocumentType : DomNode) Класс DomDtd происходит от DomNode. DomComment происходит от DomCData.
Многие примеры в этом справочнике требуют строки xml. Вместо повторения
этой строки в каждом примере, она будет помещена в файл и включена в каждый
пример. Этот include-файл показан в следующем разделе-примере. Вы можете также
создать xml-документ и читать его с помощью DomDocument_open_file() .
Пример 1. Include-файл example.inc с xml-строкой
<?php
$xmlstr = "<?xml version=’1.0’ standalone=’yes’?>
<!DOCTYPE chapter SYSTEM ’/share/sgml/Norman_Walsh/db3xml10/db3xml10.dtd’
[ <!ENTITY sp "spanish">
]>
<!-- lsfj -->
<chapter language=’en’><title language=’en’>Title</title>
<para language=’ge’>
&sp;
<!-- комментарий -->
<informaltable ID=’findme’ language=’&sp;’>
<tgroup cols=’3’>
<tbody>
<row><entry>a1</entry><entry
morerows=’1’>b1</entry><entry>c1</entry></row>
<row><entry>a2</entry><entry>c2</entry></row>
<row><entry>a3</entry><entry>b3</entry><entry>c3</entry></row>
</tbody>
</tgroup>
</informaltable>
</para>
</chapter>";
?>
Содержание DomAttribute->name
DomAttribute->specified DomAttribute->value DomDocument->add_root [не рекомендуется применять] DomDocument->create_attribute DomDocument->create_cdata_section DomDocument->create_comment DomDocument->create_element DomDocument->create_entity_reference DomDocument->create_processing_instruction DomDocument->create_text_node DomDocument->doctype DomDocument->document_element DomDocument->dump_file DomDocument->dump_mem DomDocument->get_element_by_id DomDocument->get_elements_by_tagname DomDocument->html_dump_mem DomDocumentType->entities DomDocumentType->internal_subset DomDocumentType->name DomDocumentType->notations DomDocumentType->public_id DomDocumentType->system_id DomElement->get_attribute_node DomElement->get_attribute DomElement->get_elements_by_tagname DomElement->has_attribute DomElement->remove_attribute DomElement->set_attribute_node DomElement->set_attribute DomElement->tagname DomNode->append_child DomNode->append_sibling DomNode->attributes DomNode->child_nodes DomNode->clone_node DomNode->dump_node DomNode->first_child DomNode->get_content DomNode->has_attributess DomNode->has_child_nodes DomNode->insert_before DomNode->is_blank_node DomNode->last_child DomNode->next_sibling DomNode->node_name DomNode->node_type DomNode->node_value DomNode->owner_document DomNode->parent_node DomNode->prefix DomNode->previous_sibling DomNode->remove_child DomNode->replace_child DomNode->replace_node DomNode->set_content DomNode->set_name DomNode->unlink_node DomProcessingInstruction->data DomProcessingInstruction->target domxml_new_doc domxml_open_file domxml_open_mem domxml_version domxml_xmltree xpath_eval_expression xpath_eval xpath_new_context xptr_eval xptr_new_context
