PHP DOM: Работа с XML

Конечно, элемент book должен содержать ISBN, поэтому атрибут должен быть добавлен во вновь созданный элемент. Есть два способа сделать это. Простейшим является использование setAttribute() который принимает имя атрибута и значение атрибута в качестве аргументов. Второй способ — создать объект DOMAttr а затем добавить его к элементу. DOMAttr является подклассом DOMNode , поэтому он извлекает выгоду из всех унаследованных методов и свойств, предлагаемых его родителями.

setAttribute() и setAttributeNode() отвечают за добавление и обновление атрибутов, связанных с элементом. Если атрибут не существует, он будет создан. Если он существует, он будет обновлен.

Чтобы предоставить значение для текстового элемента, рекомендуется использовать DOMCdataSection() . Главы книг даны как PCDATA, а не CDATA в DTD. Это потому, что элемент не может быть описан как содержащий непосредственно CDATA; мы должны объявить его как PCDATA, а затем обернуть содержимое в <![CDATA[...]]> . Это звучит нелогично, поскольку нам нужно иметь возможность помещать непарсированные символьные данные в текстовый элемент для последующего использования, но именно поэтому мы должны создать конкретный DOMCdataSection ; это безопасно обернет наш текст в <![CDATA[...]]> . Если вы добавите HTML-код непосредственно к узлу, вы обнаружите, что недопустимые символы, такие как <или &, будут преобразованы в соответствующие им объекты (например, & lt; и & amp;). Это потому, что эти символы имеют особое значение XML. Амперсанд для сущностей и символ «больше» начинают тег. DOM заменяет их, чтобы не вызывать проблем с синтаксическим анализом при загрузке или проверке документа.

Последний шаг в добавлении книги — сохранить новый документ обратно в файл, что делается с помощью метода save() .

Метод в целом выглядит так:

 <?php public function addBook($isbn, $title, $author, $genre, $chapters) { // create a new element represeting the new book $newbook = $this->domDocument->createElement("book"); // append the newly created element $this->domDocument->documentElement ->appendChild($newbook); // setting the attribute can be done in one of two ways // Method One: // $newbook->setAttribute("isbn", $isbn); // Method Two: $idAttribute = new DOMAttr("isbn", $isbn); $newbook->setAttributeNode($idAttribute); $title = $this->domDocument ->createElement("title", $title); $newbook->appendChild($title); $author = $this->domDocument ->createElement("author", $author); $newbook->appendChild($author); $genre = $this->domDocument ->createElement("genre", $genre); $newbook->appendChild($genre); foreach($chapters as $position => $chapter) { $newchapter = $this->domDocument ->createElement("chapter"); $newbook->appendChild($newchapter); $newchapter->setAttribute("position", $position); $newchaptitle = $this->domDocument ->createElement("chaptitle", $chapter["title"]); $newchapter->appendChild($newchaptitle); $newtext = $this->domDocument->createElement("text"); $newchapter->appendChild($newtext); // Rather than creating a new element, create a // DOMCdataSection which ensures our text is // wrapped in <![CDATA[ and ]]> $cdata = new DOMCdataSection($chapter["text"]); $newtext->appendChild($cdata); } // save the document $this->domDocument->save($this->xmlPath); } 

Удаление книги из библиотеки

Следующий метод решения — удаление книги. Это всего лишь случай определения того, какой элемент в документе XML вы хотите удалить, а затем используйте метод removeChild() для его удаления. Однако есть две важные вещи для понимания.

Во-первых, вы не можете удалить дочерний DOMDocument непосредственно из экземпляра DOMDocument . Вы должны получить доступ к элементу documentElement и удалить оттуда дочерний элемент. Это по тем же причинам, по которым вам пришлось ссылаться на documentElement при добавлении книги в библиотеку.

Во-вторых, удаление элемента из документа просто удаляет его из памяти. Если вы хотите сохранить данные, вы должны сохранить их обратно в файл.

Вот как выглядит метод deleteBook() :

 <?php public function deleteBook($isbn) { // get the book element based on its ID $book = $this->domDocument->getElementById($isbn); // simply remove the child from the documents // documentElement $this->domDocument->documentElement->removeChild($book); // save back to disk $this->domDocument->save($this->xmlPath); } 

Найти книги по жанру

Метод поиска конкретных книг по жанру использует XPath для получения нужных нам результатов. getElementById() , как вы видели ранее, является удобным способом выбора элементов из DOM, когда мы объявили ID в DTD. Но что мы можем сделать, если нам нужно запросить некоторые другие данные в XML? Мы можем использовать объект DOMXPath . Сам XPath выходит за рамки этой статьи, но я советую вам взглянуть на некоторые ресурсы, объясняющие синтаксис. Запрос XPath для поиска любого элемента книги в XML, который имеет жанр определенного типа:

  // библиотека / книга / жанр [text () = "некоторый жанр"] / .. 

Этот запрос сначала сообщает, что мы хотим получить доступ к элементу genre в пути //library/book . Две косые черты указывают, что library является корневым элементом, а одиночные косые черты указывают, что book является дочерним элементом library а genre — дочерним элементом book . [text() = "some genre"] указывает, что мы ищем, где текст внутри него — это «некоторый жанр». Сам по себе, результатом будет просто элемент жанра, поэтому /.. в конце помечается, чтобы указать, что нам действительно нужен родитель genre .

XPath — отличный способ найти узлы в структуре. Если вы обнаружите, что перебираете несколько DOMNodeLists и тестируете значения nodeValues для определенных значений, вам, вероятно, будет лучше взглянуть на эквивалентный запрос XPath, который, безусловно, будет намного короче, быстрее и проще для чтения.

Вот как выглядит метод поиска:

 <?php public function findBooksByGenre($genre) { // use XPath to find the book we"re looking for $query = '//library/book/genre[text() = "' . $genre . '"]/..'; // create a new XPath object and associate it with the document we want to query against $xpath = new DOMXPath($this->domDocument); $result = $xpath->query($query); $arrBooks = array(); // iterate of the results foreach($result as $book) { // add the title of the book to an array $arrBooks[] = $book->getElementsByTagName("title")->item(0)->nodeValue; } return $arrBooks; } 

Резюме

Эта статья была просто тестером, чтобы показать вам, как вы можете использовать DOM для манипулирования и получения отчетов из данных XML. PHP DOM не так страшен, как кажется, и вы можете обнаружить, что предпочитаете его над SimpleXML при определенных обстоятельствах.

Одной из самых важных вещей, которые вы узнали, была концепция узла, базового строительного блока XML-документа в отношении DOM. Вы увидели, как загрузить XML-документ в память и проверить его, извлекли данные из XML-документа с помощью getElementById() и getElementsByTagName() , добавили и удалили элементы, работали с атрибутами и посмотрели коллекции DOMNodeList и DOMNamedNodeMap чтобы DOMNamedNodeMap коллекции данных.

Хотя многие вещи, которые вы видели сегодня, — это вещи, которые вы, вероятно, уже легко можете сделать в SimpleXML, я надеюсь, что эта статья продемонстрировала вам, как можно достичь того же с помощью DOM и каковы некоторые из преимуществ DOM.

Изображение через Fotolia