Last updated: Fri, 05 Sep 2008

DOMDocument クラス

導入

HTML ドキュメントあるいは XML ドキュメント全体を表し、ドキュメントツリーのルートとなります。

クラス概要

DOMDocument

DOMDocument extends DOMNode {

/* プロパティ */

readonly public string $actualEncoding ;

readonly public DOMConfiguration $config ;

readonly public DOMDocumentType $doctype ;

readonly public DOMElement $documentElement ;

public string $documentURI ;

public string $encoding ;

public bool $formatOutput ;

readonly public DOMImplementation $implementation ;

public bool $preserveWhiteSpace =true ;

public bool $recover ;

public bool $resolveExternals ;

public bool $standalone ;

public bool $strictErrorChecking =true ;

public bool $substituteEntities ;

public bool $validateOnParse =false ;

public string $version ;

readonly public string $xmlEncoding ;

public bool $xmlStandalone ;

public string $xmlVersion ;

/* メソッド */

DOMDocument::__construct ([ string $version [, string $encoding ]] )

DOMAttr DOMDocument::createAttribute ( string $name )

DOMAttr DOMDocument::createAttributeNS ( string $namespaceURI , string $qualifiedName )

DOMCDATASection DOMDocument::createCDATASection ( string $data )

DOMComment DOMDocument::createComment ( string $data )

DOMDocumentFragment DOMDocument::createDocumentFragment ( void )

DOMElement DOMDocument::createElement ( string $name [, string $value ] )

DOMElement DOMDocument::createElementNS ( string $namespaceURI , string $qualifiedName [, string $value ] )

DOMEntityReference DOMDocument::createEntityReference ( string $name )

DOMProcessingInstruction DOMDocument::createProcessingInstruction ( string $target [, string $data ] )

DOMText DOMDocument::createTextNode ( string $content )

DOMElement DOMDocument::getElementById ( string $elementId )

DOMNodeList DOMDocument::getElementsByTagName ( string $name )

DOMNodeList DOMDocument::getElementsByTagNameNS ( string $namespaceURI , string $localName )

DOMNode DOMDocument::importNode ( DOMNode $importedNode [, bool $deep ] )

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

bool DOMDocument::loadHTML ( string $source )

bool DOMDocument::loadHTMLFile ( string $filename )

mixed DOMDocument::loadXML ( string $source [, int $options ] )

void DOMDocument::normalizeDocument ( void )

bool DOMDocument::registerNodeClass ( string $baseclass , string $extendedclass )

bool DOMDocument::relaxNGValidate ( string $filename )

bool DOMDocument::relaxNGValidateSource ( string $source )

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

string DOMDocument::saveHTML ( void )

int DOMDocument::saveHTMLFile ( string $filename )

string DOMDocument::saveXML ([ DOMNode $node [, int $options ]] )

bool DOMDocument::schemaValidate ( string $filename )

bool DOMDocument::schemaValidateSource ( string $source )

bool DOMDocument::validate ( void )

int DOMDocument::xinclude ([ int $options ] )

/* 継承されたメソッド */

DOMNode DOMNode::appendChild ( DOMNode $newnode )

DOMNode DOMNode::cloneNode ([ bool $deep ] )

bool DOMNode::hasAttributes ( void )

bool DOMNode::hasChildNodes ( void )

DOMNode DOMNode::insertBefore ( DOMNode $newnode [, DOMNode $refnode ] )

bool DOMNode::isDefaultNamespace ( string $namespaceURI )

bool DOMNode::isSameNode ( DOMNode $node )

bool DOMNode::isSupported ( string $feature , string $version )

string DOMNode::lookupNamespaceURI ( string $prefix )

string DOMNode::lookupPrefix ( string $namespaceURI )

void DOMNode::normalize ( void )

DOMNode DOMNode::removeChild ( DOMNode $oldnode )

DOMNode DOMNode::replaceChild ( DOMNode $newnode , DOMNode $oldnode )

}

プロパティ

actualEncoding: 非推奨。ドキュメントの実際のエンコーディング。読み込み専用で、 encoding と同等の内容です。
config: 非推奨。 DOMDocument::normalizeDocument() を実行する際に使用する設定。
doctype: このドキュメントに関連付けられた文書型宣言
documentElement: ドキュメントの子ノードであるドキュメント要素に対し、直接アクセスするために便利な属性
documentURI: ドキュメントの位置。未定義の場合は NULL
encoding: XML 宣言で指定したドキュメントのエンコーディング。この属性は、DOM Level 3 の最終的な仕様には存在しません。しかし、この実装で XML ドキュメントのエンコーディングを扱うにはこれを使用するしかありません。
formatOutput: 字下げや空白を考慮してきれいに整形した出力を行う。
implementation: このドキュメントを処理する DOMImplementation オブジェクト
preserveWhiteSpace: 余分な空白を取り除かない。デフォルトは TRUE
recover: プロプライエタリ。リカバリーモードを有効にし、整形式でないドキュメントのパースを試みます。この属性は DOM の仕様にはなく、libxml に固有のものです。
resolveExternals: 文書型宣言で外部エンティティを読み込む際に TRUE を設定する。 XML ドキュメントに文字エンティティを含める際に便利です。
standalone: 非推奨。そのドキュメントがスタンドアローンかどうかを XML 宣言で指定したもの。 xmlStandalone に対応します。
strictErrorChecking: エラー時に DOMException をスローする。デフォルトは TRUE
substituteEntities: プロプライエタリ。エンティティの置換を行うかどうか。この属性は DOM の仕様にはなく、libxml に固有のものです。
validateOnParse: DTD を読み込んで検証する。デフォルトは FALSE
version: 非推奨。 XML のバージョン。 xmlVersion に対応します。
xmlEncoding: XML 宣言の一部として、このドキュメントのエンコーディングを指定する属性。指定されていない場合や不明な場合 (たとえばドキュメントがメモリ上に存在する場合など) は NULL
xmlStandalone: XML 宣言の一部として、このドキュメントがスタンドアローンかどうかを指定する。指定されていない場合は FALSE
xmlVersion: XML 宣言の一部として、このドキュメントのバージョン番号を指定する。バージョン番号が定義されておらず、ドキュメントが "XML" の機能をサポートしている場合は、値は "1.0"

参考

» W3C specification for Document

DOMDocument::__construct — 新しい DOMDocument オブジェクトを作成する
DOMDocument::createAttribute — 新しい属性を作成する
DOMDocument::createAttributeNS — 関連付けられた名前空間に新しい属性を作成する
DOMDocument::createCDATASection — 新しい cdata ノードを作成する
DOMDocument::createComment — 新しい comment ノードを作成する
DOMDocument::createDocumentFragment — 新しい文書片を作成する
DOMDocument::createElement — 新しい要素ノードを作成する
DOMDocument::createElementNS — 関連付けられた名前空間に新しい要素を作成する
DOMDocument::createEntityReference — 新しいエンティティ参照ノードを作成する
DOMDocument::createProcessingInstruction — 新しい PI ノードを作成する
DOMDocument::createTextNode — 新しいテキストノードを作成する
DOMDocument::getElementById — id に対応する要素を検索する
DOMDocument::getElementsByTagName — 指定したタグ名に対応するすべての要素を検索する
DOMDocument::getElementsByTagNameNS — 指定した名前空間で、タグ名に対応するすべての要素を検索する
DOMDocument::importNode — 現在のドキュメントにノードをインポートする
DOMDocument::load — ファイルから XML を読み込む
DOMDocument::loadHTML — 文字列から HTML を読み込む
DOMDocument::loadHTMLFile — ファイルから HTML を読み込む
DOMDocument::loadXML — 文字列から XML を読み込む
DOMDocument::normalizeDocument — ドキュメントを正規化する
DOMDocument::registerNodeClass — 基底ノード型を作成する際に使用する拡張クラスを登録する
DOMDocument::relaxNGValidate — ドキュメントを relaxNG で検証する
DOMDocument::relaxNGValidateSource — ドキュメントを relaxNG で検証する
DOMDocument::save — 内部の XML ツリーをファイルに出力する
DOMDocument::saveHTML — 内部のドキュメントを HTML 形式の文字列として出力する
DOMDocument::saveHTMLFile — 内部のドキュメントを HTML 形式でファイルに出力する
DOMDocument::saveXML — 内部の XML ツリーを文字列として出力する
DOMDocument::schemaValidate — スキーマに基づいてドキュメントを検証する
DOMDocument::schemaValidateSource — スキーマに基づいてドキュメントを検証する
DOMDocument::validate — DTD に基づいてドキュメントを検証する
DOMDocument::xinclude — DOMDocument オブジェクト内の XIncludes を置換する

add a note User Contributed Notes
DOMDocument

Jochem Blok
15-May-2008 10:58


To indent a XML in a pretty way I use:



<?

$sXML = '<root><element><key>a</key><value>b</value></element></root>';

$doc = new DOMDocument();

$doc->preserveWhiteSpace = false;

$doc->formatOutput   = true;

$doc->loadXML($sXML);

echo $doc->saveXML();

?>

Fernando H
11-Apr-2008 04:48


Showing a quick example of how to use this class, just so that new users can get a quick start without having to figure it all out by themself. ( At the day of posting, this documentation just got added and is lacking examples. )



<?php



// Set the content type to be XML, so that the browser will   recognise it as XML.

header( "content-type: application/xml; charset=ISO-8859-15" );



// "Create" the document.

$xml = new DOMDocument( "1.0", "ISO-8859-15" );



// Create some elements.

$xml_album = $xml->createElement( "Album" );

$xml_track = $xml->createElement( "Track", "The ninth symphony" );



// Set the attributes.

$xml_track->setAttribute( "length", "0:01:15" );

$xml_track->setAttribute( "bitrate", "64kb/s" );

$xml_track->setAttribute( "channels", "2" );



// Create another element, just to show you can add any (realistic to computer) number of sublevels.

$xml_note = $xml->createElement( "Note", "The last symphony composed by Ludwig van Beethoven." );



// Append the whole bunch.

$xml_track->appendChild( $xml_note );

$xml_album->appendChild( $xml_track );



// Repeat the above with some different values..

$xml_track = $xml->createElement( "Track", "Highway Blues" );



$xml_track->setAttribute( "length", "0:01:33" );

$xml_track->setAttribute( "bitrate", "64kb/s" );

$xml_track->setAttribute( "channels", "2" );

$xml_album->appendChild( $xml_track );



$xml->appendChild( $xml_album );



// Parse the XML.

print $xml->saveXML();



?>



Output:

<Album>

  <Track length="0:01:15" bitrate="64kb/s" channels="2">

    The ninth symphony

    <Note>

      The last symphony composed by Ludwig van Beethoven.

    </Note>

  </Track>

  <Track length="0:01:33" bitrate="64kb/s" channels="2">Highway Blues</Track>

</Album>



If you want your PHP->DOM code to run under the .xml extension, you should set your webserver up to run the .xml extension with PHP ( Refer to the installation/configuration configuration for PHP on how to do this ).



Note that this:

<?php

$xml = new DOMDocument( "1.0", "ISO-8859-15" );

$xml_album = $xml->createElement( "Album" );

$xml_track = $xml->createElement( "Track" );

$xml_album->appendChild( $xml_track );

$xml->appendChild( $xml_album );

?>



is NOT the same as this:

<?php

// Will NOT work.

$xml = new DOMDocument( "1.0", "ISO-8859-15" );

$xml_album = new DOMElement( "Album" );

$xml_track = new DOMElement( "Track" );

$xml_album->appendChild( $xml_track );

$xml->appendChild( $xml_album );

?>



although this will work:

<?php

$xml = new DOMDocument( "1.0", "ISO-8859-15" );

$xml_album = new DOMElement( "Album" );

$xml->appendChild( $xml_album );

?>

add a note

DOMDocument::__construct

DOMComment::__construct

Last updated: Fri, 05 Sep 2008

DOMDocument クラス

導入

クラス概要

プロパティ

参考

目次