downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

DOMDocument::saveHTML> <DOMDocument::relaxNGValidateSource
[edit] Last updated: Fri, 25 May 2012

view this page in

DOMDocument::save

(PHP 5)

DOMDocument::save 内部の XML ツリーをファイルに出力する

説明

int DOMDocument::save ( string $filename [, int $options ] )

DOM 表現から XML ドキュメントを作成します。この関数は、通常は以下の例のように DOM ドキュメントを新しく作成した後にコールされます。

パラメータ

filename

保存された XML ドキュメントへのパス。

options

追加のオプション。現在は LIBXML_NOEMPTYTAG のみが サポートされています。

返り値

書き込んだバイト数、あるいはエラーが発生した場合は FALSE を返します。

変更履歴

バージョン 説明
5.1.0 options パラメータが追加されました。

例1 DOM ツリーをファイルに保存する

<?php

$doc 
= new DOMDocument('1.0');
// 出力はきれいに整形したいですね。
$doc->formatOutput true;

$root $doc->createElement('book');
$root $doc->appendChild($root);

$title $doc->createElement('title');
$title $root->appendChild($title);

$text $doc->createTextNode('This is the title');
$text $title->appendChild($text);

echo 
'Wrote: ' $doc->save("/tmp/test.xml") . ' bytes'// Wrote: 72 bytes

?>

参考



DOMDocument::saveHTML> <DOMDocument::relaxNGValidateSource
[edit] Last updated: Fri, 25 May 2012
 
add a note add a note User Contributed Notes DOMDocument::save
ss at littlerain dot com 01-Feb-2009 12:05
In addition to:
DOMDocument->formatOutput = true
DOMDocument->preserveWhiteSpace = false

...you also have to ensure you don't add text nodes as siblings of element nodes, or formatOutput won't work.
chenel324 at gmail dot com 19-Oct-2008 06:38
It took me forever to discover that
DOMDocument->formatOutput = true
will only have an effect on documents that are loaded from disk if one also sets
DOMDocument->preserveWhiteSpace = false ....

Hope this saves somebody a headache.
jon at mysql dot com 02-Nov-2007 02:38
If you're working with an existing XML file that contains an entity definition with an external reference like this one:

[
  <!ENTITY % all.entities SYSTEM "all-entities.ent">
  %all.entities;
]>

Be warned that DOMDocument->save() will expand this to include all definitions in all referenced entities file(s) when it writes the file. In other words, the same section of your saved file would now look something like this:

<!ENTITY % all.entities SYSTEM "all-entities.ent">
<!--
  This file names all the entity files needed by .xml files in the
  current directory.  All ENTITY declarations should be given
  first, followed by references to the those entities.
--><!ENTITY % fixedchars.entities SYSTEM "../common/fixedchars.ent">
<!ENTITY % urls.entities SYSTEM "../refman-common/urls.ent">
<!ENTITY % phrases.entities SYSTEM "../common/phrases.ent">
<!ENTITY % ndb.entities SYSTEM "ndb.en.ent">
<!ENTITY minus "&#x2013;"><!-- 2013 is actually Unicode for ndash -->
<!ENTITY Oslash "&#216;">
<!ENTITY macr "&#175;">
<!ENTITY auml "&#228;">
[etc.]

I've not found a way to keep this from occurring.
siegparr at NOSPAM dot web dot de 07-Jul-2006 08:00
The XML parser converts the text of an XML document into UTF-8, even if you have set the character encoding of the XML, for example as a second parameter of the DOMDocument constructor. After parsing the XML with the load() command all its texts have been converted to UTF-8.

In case you append text nodes with special characters (e. g. Umlaut) to your XML document you should therefore use utf8_encode() with your text to convert it into UTF-8 before you append the text to the document. Otherwise you will get an error message like "output conversion failed due to conv error" at the save() command. See example below:

<?php
// Text to insert into XML below
$txt = "a text with special characters like 'ä', 'ß', 'Ü' etc.";

// Create Instance of DOMDocument
$dom =  new DOMDocument;
// Load XML file
// Was created before with DOMDocument('1.0', 'iso-8859-1')
$dom = $dom->load("file.xml");
// Find the parent node
$parent = $dom->documentElement;
// Create Instance of DomXPath
$xpath = new DomXPath($dom);
// new node will be inserted before this node
$next = $xpath->query("//parentnode/childnode");
// Create the new element
$new_elem = $dom->createElement('new_elem');
// Insert the new element
$parent->insertBefore($new_elem, $next->item(0));
// DOMXML = utf-8! (will be converted to iso-8859-1 only at 'save()')
// prevents error message "output conversion failed due to conv error" at 'save()'
$txt = utf8_encode($txt);
// Create new text node with utf-8 encoded string
$nodetext = $dom->createTextNode("$txt");
// Append text node to new element
$nodetext = $new_elem->appendChild($nodetext);
// save
$dom->save("file.xml");
?>

Hope this helps someone.

siegparr

 
show source | credits | stats | sitemap | contact | advertising | mirror sites