XMLWriter::startDocument

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

XMLWriter::startDocument — Belgenin XML bildirimini yazar

Açıklama

Nesne yönelimli kullanım

startDocument ([ string $version [, string $encoding [, string $standalone ]]] ) : bool

Yordamsal kullanım

xmlwriter_start_document ( resource $xmlwriter [, string $version [, string $encoding [, string $standalone = NULL ]]] ) : bool

Belgenin XML bildirimini yazar.

Değiştirgeler

xmlwriter: Sadece yordamsal kullanım için. xmlwriter_open_uri() veya xmlwriter_open_memory() çağrılarıyla elde edilen, üzerinde işlem yapılacak XMLWriter özkaynağı.
version: XML bildirimindeki version özniteliğinin değeri. 1.0 öntanımlıdır.
encoding: XML bildirimindeki encoding özniteliğinin değeri. Öntanımlı olarak bu öznitelik belirtilmez.
standalone: XML bildirimindeki standalone özniteliğinin değeri. yes veya no olabilir.

Dönen Değerler

Başarı durumunda TRUE, başarısızlık durumunda FALSE döner.

Ayrıca Bakınız

XMLWriter::endDocument() - Geçerli belgeyi sonlandırır

add a note

User Contributed Notes 2 notes

down

msbmail at gmail dot com ¶

11 years ago


Some errors in generating the XML document are related to the format used to write the PHP file from which the XML is generated.

In Windows environments, be sure to save your documents in ANSI / ASCII and you will avoid many of them.

down

icepick dot pt at hotmail dot com ¶

15 years ago


I was having a very hard time triyng to use:

$writer->startDocument( '1.0' , 'Windows-1252' );

Somehow this caused the generation of an empty xml file, and I could not figure out why.
When all other efforts failed I asked for help to the team that developed the XMLwriter extension, and got a very quick reply as follows:

Quote:
==============================
Windows-1252 support is only available if libxml2 is link with iconv 
support (it usually is, but there are exceptions). I know on my Mac, the 
built in libxml2 doesnt provide iconv support - they go with some 
Unicode hack which doesnt provide it, so I had to build my own. It is 
built by default (and your code works) on my linux machines.
 
It is possible to create the XML without a declaration, which means you 
could add it manually, but if you use any characters that are differnt 
between UTF-8 and Windows-1252, the encoding would be wrong in the 
document, so do not recommend.
==============================

Then light was made on my head: I am using a linux server distribution that by default is still running PHP 4.3. A few months ago I decided to force the upgrade of PHP to the newest version 5.1.6 at that time, and that has brougth me the XMLwriter extension that I am now using. But clearly there are compatibility issues betwen the rest of the server's defaults and PHP 5 wich is probably why it's development team has not upgraded yet.

Let's hope all the remaining environments catch up with this extension. It is in fact most handy.

And in the meantime, I have figured out a (not recomended, obviously) workaroud that works for me:

Instead of using two parameters, I used only the first one: 

$writer->startDocument( '1.0" encoding="Windows-1252' );

this will output:

<?xml version="1.0" encoding="Windows-1252"?>

add a note