警告 |
このモジュールは、実験的なものです。これは、これらの関数の動作、関数名は、このドキュメントに書かれて事項と同様に告知なく将来的なPHPのリリースで変更される可能性があります。注意を喚起するとともに、このモジュールは使用者のリスクで使用して下さい。 |
このモジュールの関数は、configure時に --with-dom=[DIR]を指定し、 GNOME xmlライブラリを使用して構 築された場合にのみ利用可能です。少なくともlibxml-2.2.7が必要です。 これらの関数は、PHP4で追加されました。
本モジュールによりXMLドキュメントをDOM APIにより操作することが可能 になります。XMLドキュメント全体を PHPオブジェクトツリーに変換する xmltree()関数もサポートされます。現在、このツリー は読み込みのみが可能であり、修正することはできません。しかし、 dumpmem() を適用することができないため、この制 約には意味がありません。このため、XMLファイルを読み込んで修正した バージョンを書き込みたい場合には、add_node()、 set_attribute()等を使用し、最後に dumpmem() 関数を使用して下さい。
本モジュールは、次の定数を定義します。
表 1XML定数
定数 | 値 | 説明 |
---|---|---|
XML_ELEMENT_NODE | 1 | このノードはエレメントです |
XML_ATTRIBUTE_NODE | 2 | このノードは属性です |
XML_TEXT_NODE | 3 | このノードはテキスト部です |
XML_CDATA_SECTION_NODE | 4 | |
XML_ENTITY_REF_NODE | 5 | |
XML_ENTITY_NODE | 6 | このノードは のようなエンティティです |
XML_PI_NODE | 7 | このノードは処理命令(PI)です |
XML_COMMENT_NODE | 8 | このノードはコメントです |
XML_DOCUMENT_NODE | 9 | このノードはドキュメントです |
XML_DOCUMENT_TYPE_NODE | 10 | |
XML_DOCUMENT_FRAG_NODE | 11 | |
XML_NOTATION_NODE | 12 | |
XML_GLOBAL_NAMESPACE | 1 | |
XML_LOCAL_NAMESPACE | 2 |
本モジュールの各関数は、2種類の方法で使用可能です。オブジェクト指 向的でない手法としては最初の引数としてオブジェクトを渡す方法があり、 オブジェクト指向的な方法としては関数をオブジェクトのメソッドとして コールする方法があります。本ドキュメントは、オブジェクト指向的でな い関数を説明しますが、接頭辞 "domxml_" を省略することによりオブジェ クト指向的メソッドを使用することが可能です。以下のテーブルに全ての クラス、その属性とメソッドを示します。
本モジュールは、以下のテーブルに示す —プロパティおよびメソッ ドを含む — 多くのクラスを定義します。
表 2DomDocument クラス (メソッド)
メソッド名 | 関数名 | 説明 |
---|---|---|
root | domxml_root() | |
children | domxml_children() | |
add_root | domxml_add_root() | |
dtd | domxml_intdtd() | |
dumpmem | domxml() | |
xpath_init | xpath_init | |
xpath_new_context | xpath_new_context | |
xptr_new_context | xptr_new_context |
表 3DomDocument クラス (属性)
名前 | 型 | 説明 |
---|---|---|
doc | class DomDocument | オブジェクト自身 |
name | string | |
url | string | |
version | string | XMLのバージョン |
encoding | string | |
standalone | long | このファイルがstandaloneバージョンの場合に1 |
type | long | 表中の定数のどれか ... |
compression | long | このファイルが圧縮されている場合に1 |
charset | long |
表 4DomNode class (メソッド)
名前 | PHP名 | 説明 |
---|---|---|
lastchild | domxml_last_child() | |
children | domxml_children() | |
parent | domxml_parent() | |
new_child | domxml_new_child() | |
get_attribute | domxml_get_attribute() | |
set_attribute | domxml_set_attribute() | |
attributes | domxml_attributes() | |
node | domxml_node() | |
set_content() | domxml_set_content |