Last updated: Fri, 20 May 2011

XMLWriter::writeCData

(PHP 5 >= 5.1.2, PECL xmlwriter >= 0.1.0)

XMLWriter::writeCData — Escribe una etiqueta completa del CDATA

Descripción

Estilo orientado a objetos

bool XMLWriter::writeCData ( string $content )

Estilo por procesos

bool xmlwriter_write_cdata ( resource $xmlwriter , string $content )

Escribe un completo CDATA.

Parámetros

xmlwriter: Sólo para llamadas procedimentales. El resource XMLWriter que está siendo modificado. Este recurso proviene de una llamada a xmlwriter_open_uri() o xmlwriter_open_memory().
content: El contenido del CDATA.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ver también

XMLWriter::startCData() - Crea la etiqueta de inicio de CDATA
XMLWriter::endCData() - Fin del actual CDATA

XMLWriter::writeComment

XMLWriter::writeAttribute

Last updated: Fri, 20 May 2011

add a note User Contributed Notes XMLWriter::writeCData

t dot w dot natt at UNIVERSITY dot bath dot ac dot uk 09-Sep-2008 03:18


Seen a couple of bug reports and gotchas with this one but not a simple code example. Just in case someone finds it useful:



<?php



// serve xml doc as xml

header('Content-type: application/xml');



// set up the document

$xml = new XmlWriter();

$xml->openMemory();

$xml->startDocument('1.0', 'UTF-8');

$xml->startElement('mydoc');

$xml->startElement('myele');



// CData output

$xml->startElement('mycdataelement');

$xml->writeCData("text for inclusion within CData tags");

$xml->endElement();



// end the document and output

$xml->endElement();

$xml->endElement();

echo $xml->outputMemory(true);

?>



Outputs:

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

<mydoc>

    <myele>

        <mycdataelement><![CDATA[text for inclusion within CData tags]]>

        </mycdataelement>

    </myele>

</mydoc>

harvey dot robin at gmail dot com 08-Sep-2007 11:57


This function will not have any effect if the last node you output was a text node.  This includes whitespace.  Example:



<?php

/*

<html>

<![CDATA[ Summut nice ]]>

<p>something</p>

</html>

*/

$xw = new XMLWriter;

$xw->openMemory();

$xw->startDocument('1.0', 'ISO-8859-1');

$xw->startElement('html');

$xw->text('Comment out this line to get the CDATA back!!');

$xw->writeCData('Summut nice');

$xw->writeElement('p', 'something');

$xw->endElement();

$xw->endDocument();

echo $xw->outputMemory();

?>

thesoupdragon at hotmail dot com 21-Jun-2007 09:14


A rather strange effect with this.



UTF8 Mysql database 



                            $xml->startElement('tablecolor2');

    $xml->writeCData( $tablecolor2 );

    $xml->endElement();



does not work !



but 

                            $xml->startElement('tablecolor2');

    $tablecolor2 = utf8_decode ( $val['pcolor2']);

    $xml->writeCData( utf8_encode ($tablecolor2) );

    $xml->endElement();



cannot explain this - but it may help someone

dave at dtracorp dot com 06-Mar-2007 09:30


i don't know if this is a bug with the underlying c code or not, or this is by design (i'm not a big xml guy), but for me, running on fedora core 5, php 5.2.1

to get this to work, the cdata functions need to wrap the description (or whatever element the cdata should appear in)

for example.

// initiate xmlwriter object as $xw

// add header, titles, etc.



// start cdata

$xw->startCData();

// start description

$xw->startElement('description');

// write cdata

$xw->writeCData('<img src="http://php.net/images/php.gif" />');

// write the description contents

$xw->text('php logo');

// end the description element

$xw->endElement();

// end the cdata

$xw->endCData();



// end xml, and output



otherwise, i just got warnings about writing cdata in the wrong context, and no cdata would be written

add a note