ref.simplexml FROM DYPA
| From: | 007not at gmail dot com | Date: | Sat, 12 Jan 2008 08:36:00 +0000 |
| Subject: | ref.simplexml FROM DYPA | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-816@lists.php.net to get a copy of this message | ||
Здравствуйте, doc-ru.
в паре мест перевода нет, оставил англоязычн версии
SimpleXML functions
Введение
(в оригинале ошибка toolset должен быть раздельно, см lingvo)
+Это расширение - очень простой и лёгкий для
использовании набор инструментов позволяющий
работать с XML документов как с обьектом, который уже
может быть обработан с помошью normal property selectors и
итераторов массивов.
The SimpleXML extension provides a very simple and easily usable toolset to convert XML to an object
that can be processed with normal property selectors and array iterators.
Требования
SimpleXML требует PHP 5.
The SimpleXML extension requires PHP 5.
Установка
Это расширение включенно по умолчанию. Для отключения
его, используйте директиву --disable-simplexml.
The SimpleXML extension is enabled by default. To disable it, use the --disable-simplexml configure
option.
Примеры
Многие из примеров на данной странице требуют XML
строку. Вместо повторения этой строки в каждом примере
мы запишем её в файл, который будем инклудить в каждом
примере. Инклудящийся файл приведен в примере 1. В
качестве альтернативы вы можете создать XML документ и
читать его с помошью simplexml_load_file().
Many examples in this reference require an XML string. Instead of repeating this string in every
example, we put it into a file which we include in each example. This included file is shown in the
following example section. Alternatively, you could create an XML document and read it with
simplexml_load_file().
Пример#1 Файл для инклуда example.php с XML строкой
Example#1 Include file example.php with XML string
Простота SimpleXML прояляется когда извлекается строка
или число из XML документа.
The simplicity of SimpleXML appears most clearly when one extracts a string or number from a basic
XML document.
Пример#2 Достаем <plot>
Example#2 Getting <plot>
Доступ к элементам внутри XML документа которые
содержат символы не разрешенные under PHP's naming convention
(пример тире) может быть достигнут при помоши
экранирования имени элемента с помошью скобок или
апострофа.
Accessing elements within an XML document that contain characters not permitted under PHP's
naming convention (e.g. the hyphen) can be accomplished by encapsulating the element name within
braces and the apostrophe.
Пример#3 Достаем <line>
Example#3 Getting <line>
Пример#4 Доступ к неуникальным элементам в SimpleXML
Example#4 Accessing non-unique elements in SimpleXML
When multiple instances of an element exist as children of a single parent element, normal iteration
techniques apply.
When multiple instances of an element exist as children of a single parent element, normal iteration
techniques apply.
Пример#5 Использование аттрибутов
Example#5 Using attributes
До сих пор мы только показали как читать имена и
значения элементов. SimpleXML также имеет доступ к
аттрибутам элемента. Access attributes of an element just as you would elements of
an array...
So far, we have only covered the work of reading element names and their values. SimpleXML can also
access element attributes. Access attributes of an element just as you would elements of an array.
Пример#6 Сравнеине элементов и аттрибутов с текстом
Example#6 Comparing Elements and Attributes with Text
Для сравнения элемента или аттрибута с строкой или
передачи в функцию которая требует строку вы должны
привести ее к типу строка используя (string). В других
обстоятельствах PHP обращается с элементом как с
обьектом.
To compare an element or attribute with a string or pass it into a function that requires a string,
you must cast it to a string using (string). Otherwise, PHP treats the element as an object.
Пример#7 Использование XPath
Example#7 Using XPath
В SimpleXML втроенна подддержка XPath... Для нахождения всех
элементов <character>:
SimpleXML includes built-in XPath support. To find all <character> elements:
'//' служит как групповой символ. Для абсолютного
определения пути исключите один из слешей.
'//' serves as a wildcard. To specify absolute paths, omit one of the slashes.
Example#8 Установка значений
Данные в SimpleXML не являются константой. Обьект
позволяет манипуляции со всеми его элементами.
Data in SimpleXML doesn't have to be constant. The object allows for manipulation of all of its
elements.
Код наверху выведет новый XML документ, который похож на
оригинальный, за исключением того что в новом XML
документе будет изменен Ms. Coder на Miss Coder.
The above code will output a new XML document, just like the original, except that the new XML will
change Ms. Coder to Miss Coder.
Example#9 Добавление элементов и аттрибутов
Начиная с PHP 5.1.3 SimpleXML имеет возможность легко
добавлять потомков и аттрибуты.
Since PHP 5.1.3, SimpleXML has had the ability to easily add children and attributes.
Код наверху выведет XML документ основанный на
оригинальном, но имеющий новый персонаж и рейтинг.
The above code will output an XML document based on the original but having a new character and
rating.
Example#10 Взаимодействиие с DOM
PHP имеет механизм для конвертирования XML нод между
форматами SimpleXML и DOM. Этот пример показывает как
следует передавать DOM элемент в SimpleXML.
PHP has a mechanism to convert XML nodes between SimpleXML and DOM formats. This example shows how
one might change a DOM element to SimpleXML.
Table of Contents
* SimpleXMLElement->addAttribute() — Добавляет аттрибут в SimpleXML
элемент(Adds an attribute to the SimpleXML element)
* SimpleXMLElement->addChild() — Добавляет потомка в XML нод (Adds a
child element to the XML node)
* SimpleXMLElement->asXML() — Return a well-formed XML string based on SimpleXML element
* SimpleXMLElement->attributes() — Распознает аттрибуты элемента
(Identifies an element's attributes)
* SimpleXMLElement->children() — Находит потомков выбранного
нода (Finds children of given node)
* SimpleXMLElement->__construct() — Создает новый SimpleXMLElement обьект
(Creates a new SimpleXMLElement object)
* SimpleXMLElement->getDocNamespaces() — Возвращает неймспейс
определенный в документе (Returns namespaces declared in document)
* SimpleXMLElement->getName() — Возвращает имя XML элемента (Gets the
name of the XML element)
* SimpleXMLElement->getNamespaces() — Возвращает используемый в
документе (Returns namespaces used in document)
* SimpleXMLElement->registerXPathNamespace() — Creates a prefix/ns context for the next
XPath query
* SimpleXMLElement->xpath() — Выполняет XPath запрос к XML данным
(Runs XPath query on XML data)
* simplexml_import_dom — Создает SimpleXMLElement обект из DOM
обьекта(Get a SimpleXMLElement object from a DOM node)
* simplexml_load_file — Переводит XML документ в обьект (Interprets an
XML file into an object)
* simplexml_load_string — Переводит XML строку в обьект (Interprets a
string of XML into an object)
--
С уважением,
007NOT mailto:007NOT@gmail.com