<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="simplexml.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

&reftitle.examples;

<section xml:id="simplexml.examples-basic">

<title>Uso básico de SimpleXML</title>

<para>

Varios ejemplos de este capítulo requieren una cadena XML. En lugar de

repetirla en cada ejemplo, se colocará en un archivo que se incluirá en

cada uno de ellos. El contenido de este archivo se ilustra con el ejemplo

que sigue. De lo contrario, puede crearse un documento XML y leerse con

<function>simplexml_load_file</function>.

</para>

<para>

<example>

<title>Ejemplo de archivo incluido examples/simplexml-data.php con una cadena XML</title>

<programlisting role="php" xml:id="simplexml.examples.movie">

</programlisting>

</example>

</para>

<para>

La simplicidad de SimpleXML se hace más evidente cuando se intenta

extraer una cadena o un número de un documento XML básico.

<example>

<title>Lectura de <literal>&lt;plot&gt;</literal></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

El acceso a los elementos de un documento XML que contiene caracteres no permitidos

según la convención de nombres de PHP (por ejemplo, palabras clave) es posible

encapsulando el nombre del elemento entre corchetes y comillas simples.

<example>

<title>Recuperación de <literal>&lt;line&gt;</literal></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Acceder a un elemento no único con SimpleXML</title>

<simpara>

Cuando existen múltiples instancias de un elemento como hijos de un

elemento padre único, pueden aplicarse las técnicas normales de iteración.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<note>

<para>

Las propiedades (<literal>$movies->movie</literal> en nuestro ejemplo anterior)

no son arrays. Son objetos

<link linkend="class.iterator">iterables</link> y

<link linkend="class.arrayaccess">accesibles</link>.

</para>

</note>

<para>

<example>

<title>Uso de atributos</title>

<simpara>

Hasta ahora, solo se ha cubierto la lectura de los nombres de los elementos

y sus valores. SimpleXML también puede acceder a sus atributos.

El acceso a los atributos de un elemento se realiza de la misma manera que

el acceso a los elementos de un array.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Comparación de elementos y atributos con texto</title>

<simpara>

Para comparar un elemento o un atributo con una cadena de caracteres

o para pasarlo a una función que requiera una cadena de caracteres,

debe convertirse en una cadena utilizando

<literal>(string)</literal>.

De lo contrario, PHP tratará el elemento como un objeto.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Comparación de 2 elementos</title>

<simpara>

Dos objetos <classname>SimpleXMLElement</classname>

se consideran diferentes incluso si

apuntan al mismo elemento.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Uso de XPath</title>

<simpara>

SimpleXML incluye soporte integrado para <acronym>XPath</acronym>.

Para encontrar todos los elementos <literal>&lt;character&gt;</literal>.

</simpara>

<simpara>

'<literal>//</literal>' actúa como comodín. Para especificar una ruta absoluta,

se elimina una barra.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Asignación de valores</title>

<simpara>

Los datos en SimpleXML no tienen que ser constantes. El objeto permite

la manipulación de todos estos elementos.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Añadir elementos y atributos</title>

<simpara>

SimpleXML es capaz de añadir fácilmente

hijos y atributos.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Interoperabilidad DOM</title>

<simpara>

PHP tiene un mecanismo para convertir nodos XML entre los formatos

SimpleXML y DOM. Este ejemplo muestra cómo cambiar un elemento DOM a

SimpleXML.

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Uso de espacios de nombres</title>

<programlisting role="php">

<![CDATA[

</programlisting>

</example>

</para>

</section>

<section xml:id="simplexml.examples-errors">

<title>Manejo de errores XML</title>

<para>

El manejo de errores XML al cargar un documento es

una tarea sencilla. Utilizando las funcionalidades

<link linkend="book.libxml">libxml</link>, es posible suprimir

todos los errores XML al cargar un documento, y luego recorrerlos.

</para>

<para>

El objeto <classname>LibXMLError</classname>, devuelto por la función

<function>libxml_get_errors</function>, contiene varias propiedades

como el <link linkend="libxmlerror.props.message">mensaje</link>,

la <link linkend="libxmlerror.props.line">línea</link> y la

<link linkend="libxmlerror.props.column">columna</link> (posición) del error.

</para>

<para>

<example>

<title>Carga de cadenas XML rotas</title>

<programlisting role="php" xml:id="simplexml.examples.error">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<section role="seealso"><!-- {{{ -->

&reftitle.seealso;

<para>

<simplelist>

<member><function>libxml_use_internal_errors</function></member>

<member><function>libxml_get_errors</function></member>

<member><xref linkend="class.libxmlerror" /></member>

</simplelist>

</para>

</section>

</section>

</chapter>