Page Contents

XML

O helper XML simplifica a saída de documentos XML.

serialize

serialize($data, $options = array())

  • mixed $data - O conteúdo a ser convertido para XML

  • mixed $options - Opções de formatação de dados. Para uma lista das opções válidas, veja Xml::__construct()

    • string $options[“root”] - O nome do elemento raíz, o padrão é “#document”

    • string $options[“version”] - A versão do XML, o padrão é “1.0”

    • string $options[“encoding”] - A codificação do documento, o padrão é “UTF-8”

    • array $options[“namespaces”] - Um array de namespaces (como strings) usados neste documento

    • string $options[“format”] - Especifica o formato para o qual este documento será convertido quando analisado e renderizado como texto, se como “attributes” ou “tags”, o padrão é “attributes”

    • array $options[“tags”] - Um array especificando quaisquer opções de formatação relativas às tags, indexado pelo nome da tag. Veja XmlNode::normalize()

O método serialize pega um array e cria uma string XML dos dados. Isto é comumente usado para serializar dados de model.

<?php
echo $xml->serialize($data);
 o formato será semelhante à:
 <model_name id="1" field_name="content" />
?>

O método serialize age como um atalho para instanciação de classes XML predefinidas e utilizando o método toString para isso. Se você precisar de mais controler sobre a serialização, você pode querer invocar a classe XML diretamente.

Você pode modificar como um dado é serializado usando o atributo format. Por padrão, os dados serão serializados como atribuitos. Se você definir o valor de format para «tags», os dados serão serializados como tags.

pr($data);

Array
(
    [Baker] => Array
        (
            [0] => Array
                (
                    [name] => The Baker
                    [weight] => heavy
                )
            [1] => Array
                (
                    [name] => The Cook
                    [weight] => light-weight
                )
        )
)

pr($xml->serialize($data));

<baker>
     <baker name="The Baker" weight="heavy" />
     <baker name="The Cook" weight="light-weight" />
</baker>

pr($xml->serialize($data, array('format' => 'tags')));

<baker>
    <baker>
        <name><![CDATA[The Baker]]></name>
        <weight><![CDATA[heavy]]></weight>
    </baker>
    <baker>
        <name><![CDATA[The Cook]]></name>
        <weight><![CDATA[light-weight]]></weight>
    </baker>
</baker>

elem

O método elem permite que você construa uma string de um nó XML com atributos e conteúdo interno.

string elem (string $name, $attrib = array(), mixed $content = null, $endTag = true)

echo $xml->elem('count', array('namespace' => 'myNameSpace'), 'content');
// gera: <myNameSpace:count>content</count>

Se você quiser delimitar o texto de seu nó com CDATA, o terceiro argumento deve ser um array contendo dois índices: “cdata” e “value”

echo $xml->elem('count', null, array('cdata'=>true,'value'=>'content'));
// gera: <count><![CDATA[content]]></count>