xml

xml_parser_create()および xml_parser_create_ns() により返された xmlリソースは、 このエクステンションにより提供された関数で使用される XMLパーサのインスタンスを参照します。

XML エレメント構造の例

この最初の例は、あるドキュメント中のstart エレメントの構造をイン デントを付けて表示します。

例 1. XML エレメント構造を表示 <?php $file = "data.xml"; $depth = array(); function startElement($parser, $name, $attrs) {     global $depth;     for ($i = 0; $i < $depth[$parser]; $i++) {         print "  ";     }     print "$name\n";     $depth[$parser]++; } function endElement($parser, $name) {     global $depth;     $depth[$parser]--; } $xml_parser = xml_parser_create(); xml_set_element_handler($xml_parser, "startElement", "endElement"); if (!($fp = fopen($file, "r"))) {     die("XML 入力をオープンできませんでした"); } while ($data = fread($fp, 4096)) {     if (!xml_parse($xml_parser, $data, feof($fp))) {         die(sprintf("XML エラー: %s が %d 行目で発生しました",                     xml_error_string(xml_get_error_code($xml_parser)),                     xml_get_current_line_number($xml_parser)));     } } xml_parser_free($xml_parser); ?>

XMLタグのマッピングの例

例 2. XMLをHTMLにマップする この例は、XMLドキュメントのタグを直接HTMLタグにマップします。 "map array" にないエレメントは無視されます。もちろん、この例は、 特定の XML ドキュメント型を有する場合のみ動作します。 <?php $file = "data.xml"; $map_array = array(     "BOLD"     => "B",     "EMPHASIS" => "I",     "LITERAL"  => "TT" ); function startElement($parser, $name, $attrs) {     global $map_array;     if (isset($map_array[$name])) {         echo "<$map_array[$name]>";     } } function endElement($parser, $name) {     global $map_array;     if (isset($map_array[$name])) {         echo "</$map_array[$name]>";     } } function characterData($parser, $data) {     echo $data; } $xml_parser = xml_parser_create(); // case-folding を用いることで、$map_array から確実にタグを見つけられるようにします xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, true); xml_set_element_handler($xml_parser, "startElement", "endElement"); xml_set_character_data_handler($xml_parser, "characterData"); if (!($fp = fopen($file, "r"))) {     die("XML 入力をオープンできませんでした"); } while ($data = fread($fp, 4096)) {     if (!xml_parse($xml_parser, $data, feof($fp))) {         die(sprintf("XML エラー: %s が %d 行目で発生しました",                     xml_error_string(xml_get_error_code($xml_parser)),                     xml_get_current_line_number($xml_parser)));     } } xml_parser_free($xml_parser); ?>

XML 外部エンティティの例

この例は、XML コードに焦点を当てます。この例は、他のドキュメント をインクルードし処理するための外部エンティティリファレンスのハン ドラの使用法およびPIの処理方法、PIが含むコードに関する"信頼度" を定義する手段を説明します。

この例で使用される XML ドキュメントは、例題ファイル (xmltest.xml および xmltest2.xml) にあります。

例 3. 外部エンティティの例 <?php $file = "xmltest.xml"; function trustedFile($file) {     // 信頼できるのは、自分自身が所有しているローカルファイルのみです     if (!eregi("^([a-z]+)://", $file)         && fileowner($file) == getmyuid()) {             return true;     }     return false; } function startElement($parser, $name, $attribs) {     echo "&lt;<font color=\"#0000cc\">$name</font>";     if (count($attribs)) {         foreach ($attribs as $k => $v) {             echo " <font color=\"#009900\">$k</font>=\"<font                    color=\"#990000\">$v</font>\"";         }     }     echo "&gt;"; } function endElement($parser, $name) {     echo "&lt;/<font color=\"#0000cc\">$name</font>&gt;"; } function characterData($parser, $data) {     echo "<b>$data</b>"; } function PIHandler($parser, $target, $data) {     switch (strtolower($target)) {         case "php":             global $parser_file;             // もし「信頼できる」ドキュメントだった場合、その中に書かれている             // PHP コードを実行しても安全だと考えます。そうでない場合、             // コードを実行するかわりにコードそのものを表示します。             if (trustedFile($parser_file[$parser])) {                 eval($data);             } else {                 printf("信頼できない PHP コード: <i>%s</i>",                         htmlspecialchars($data));             }             break;     } } function defaultHandler($parser, $data) {     if (substr($data, 0, 1) == "&" && substr($data, -1, 1) == ";") {         printf('<font color="#aa00aa">%s</font>',                 htmlspecialchars($data));     } else {         printf('<font size="-1">%s</font>',                 htmlspecialchars($data));     } } function externalEntityRefHandler($parser, $openEntityNames, $base, $systemId,                                   $publicId) {     if ($systemId) {         if (!list($parser, $fp) = new_xml_parser($systemId)) {             printf("エンティティ %s (%s にある) をオープンできませんでした\n", $openEntityNames,                    $systemId);             return false;         }         while ($data = fread($fp, 4096)) {             if (!xml_parse($parser, $data, feof($fp))) {                 printf("XML エラー: %s が、%d 行目でエンティティ %s のパース中に発生しました\n",                        xml_error_string(xml_get_error_code($parser)),                        xml_get_current_line_number($parser), $openEntityNames);                 xml_parser_free($parser);                 return false;             }         }         xml_parser_free($parser);         return true;     }     return false; } function new_xml_parser($file) {     global $parser_file;     $xml_parser = xml_parser_create();     xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, 1);     xml_set_element_handler($xml_parser, "startElement", "endElement");     xml_set_character_data_handler($xml_parser, "characterData");     xml_set_processing_instruction_handler($xml_parser, "PIHandler");     xml_set_default_handler($xml_parser, "defaultHandler");     xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler");     if (!($fp = @fopen($file, "r"))) {         return false;     }     if (!is_array($parser_file)) {         settype($parser_file, "array");     }     $parser_file[$xml_parser] = $file;     return array($xml_parser, $fp); } if (!(list($xml_parser, $fp) = new_xml_parser($file))) {     die("XML 入力をオープンできませんでした"); } echo "<pre>"; while ($data = fread($fp, 4096)) {     if (!xml_parse($xml_parser, $data, feof($fp))) {         die(sprintf("XML エラー: %s が %d 行目で発生しました\n",                     xml_error_string(xml_get_error_code($xml_parser)),                     xml_get_current_line_number($xml_parser)));     } } echo "</pre>"; echo "パースが完了しました\n"; xml_parser_free($xml_parser); ?>

例 4. xmltest.xml <?xml version='1.0'?> <!DOCTYPE chapter SYSTEM "/just/a/test.dtd" [ <!ENTITY plainEntity "FOO entity"> <!ENTITY systemEntity SYSTEM "xmltest2.xml"> ]> <chapter> <TITLE>Title &plainEntity;</TITLE> <para> <informaltable> <tgroup cols="3"> <tbody> <row><entry>a1</entry><entry morerows="1">b1</entry><entry>c1</entry></row> <row><entry>a2</entry><entry>c2</entry></row> <row><entry>a3</entry><entry>b3</entry><entry>c3</entry></row> </tbody> </tgroup> </informaltable> </para> &systemEntity; <section id="about"> <title>About this Document</title> <para> <!-- this is a comment --> <?php print 'Hi! This is PHP version '.phpversion(); ?> </para> </section> </chapter>

このファイルは、xmltest.xml からインクルードされます。

例 5. xmltest2.xml <?xml version="1.0"?> <!DOCTYPE foo [ <!ENTITY testEnt "test entity"> ]> <foo> <element attrib="value"/> &testEnt; <?php print "This is some more PHP code being executed."; ?> </foo>