xml|関數(shù)

PHP の XML 解析関數(shù)

まず第一に、私はコンピューター標(biāo)準(zhǔn)が好きであることを認(rèn)めなければなりません。もし誰もが業(yè)界の標(biāo)準(zhǔn)に従えば、インターネットはより良いメディアになるでしょう。標(biāo)準(zhǔn)化されたデータ交換フォーマットの使用により、オープンでプラットフォームに依存しないコンピューティング モデルが実現(xiàn)可能になります。それが私が XML 愛好家である理由です。

幸いなことに、私のお?dú)荬巳毪辘违攻辚抓妊哉Zは XML をサポートしているだけでなく、XML のサポートも強(qiáng)化されています。 PHP を使用すると、XML ドキュメントをインターネットにすばやく公開したり、XML ドキュメントに関する統(tǒng)計情報を収集したり、XML ドキュメントを他の形式に変換したりすることができます。たとえば、私は XML で書いた記事や書籍を管理するために、PHP の XML 処理機(jī)能をよく使用します。

この記事では、PHP の組み込み Expat パーサーを使用して XML ドキュメントを処理する方法について説明します。例を通して、Expat の処理方法を説明します。同時に、サンプルは次の方法を示します:

獨(dú)自の処理関數(shù)を構(gòu)築する
XML ドキュメントを獨(dú)自の PHP データ構(gòu)造に変換する

Expat を?qū)毪工?

XML パーサー (XML プロセッサーとも呼ばれる) は、プログラムにアクセスできる構(gòu)造とXML ドキュメントのコンテンツ。 Expat は、PHP スクリプト言語用の XML パーサーです。 Mozilla、Apache、Perl などの他のプロジェクトでも使用されます。

イベントベースのパーサーとは何ですか?

XML パーサーの 2 つの基本的なタイプ:

ツリーベースのパーサー: XML ドキュメントをツリー構(gòu)造に変換します。このタイプのパーサーは、結(jié)果のツリーの各要素にアクセスするための API を提供しながら、記事全體を解析します。その共通規(guī)格は DOM (Document Object Mode) です。
イベントベースのパーサー: XML ドキュメントを一連のイベントとして扱います。特別なイベントが発生すると、パーサーは開発者が提供する関數(shù)を呼び出してそれを処理します。
イベントベースのパーサーは、XML ドキュメントのデータ中心のビューを備えています。これは、XML ドキュメントの構(gòu)造ではなくデータ部分に焦點(diǎn)を當(dāng)てていることを意味します。これらのパーサーはドキュメントを最初から最後まで処理し、コールバック関數(shù)を通じて要素の開始、要素の終了、特徴データの開始などのイベントをアプリケーションに報告します。以下は、「Hello-World」の XML ドキュメントの例です。


Hello World


イベントベースのパーサーは、次の 3 つのイベントとしてレポートします。
CDATA 値を持つ項目の開始: Hello World
終了要素: 挨拶
ツリーベースのパーサーとは異なり、イベントベースのパーサーはドキュメントを記述する構(gòu)造を生成しません。 CDATA アイテムでは、イベントベースのパーサーでは親要素の挨拶情報を取得できません。
ただし、より低いレベルのアクセスが提供されるため、リソースの有効活用とより高速なアクセスが可能になります。この方法では、ドキュメント全體をメモリに収める必要がなく、実際にはドキュメント全體が実際のメモリ値よりも大きくなる場合もあります。


Expat は、そのようなイベントベースのパーサーです。もちろん、Expat を使用する場合は、必要に応じて PHP で完全なネイティブ ツリー構(gòu)造を生成することもできます。


上記の Hello-World の例には、完全な XML 形式が含まれています。ただし、関連付けられた DTD (Document Type Definition) も埋め込まれた DTD も存在しないため、これは無効です。


Expat の場合、これは何の違いもありません。Expat は有効性をチェックしないパーサーであるため、ドキュメントに関連付けられた DTD を無視します。ただし、ドキュメントを完全にフォーマットする必要があることに注意してください。そうでないと、Expat (他の XML 準(zhǔn)拠パーサーと同様) がエラー メッセージを表示して停止します。


有効性をチェックしないパーサーとして、Exapt は速度と軽量であるため、インターネット プログラムに非常に適しています。


Expat のコンパイル

Expat は PHP3.0.6 バージョン (またはそれ以降) にコンパイルできます。 Apache 1.3.9 以降、Expat は Apache の一部として含まれています。 Unix システムでは、-with-xml オプションを使用して PHP を構(gòu)成することで、PHP にコンパイルできます。


PHP を Apache モジュールとしてコンパイルする場合、Expat はデフォルトで Apache の一部として含まれます。 Windows では、XML ダイナミック リンク ライブラリをロードする必要があります。

XML 例: XMLstats

Expat の機(jī)能を理解する 1 つの方法は、例を通して見ることです。これから説明する例では、Expat を使用して XML ドキュメントの統(tǒng)計を収集します。


ドキュメント內(nèi)の各要素について、以下の情報が出力されます:

ドキュメント內(nèi)で要素が使用された回數(shù)
要素內(nèi)の文字データの數(shù)
要素の親要素
子要素要素の親要素と子要素を保存するための構(gòu)造體を生成するために PHP を使用します

準(zhǔn)備

XML パーサー インスタンスの生成に使用される関數(shù)は、xml_parser_create() です。このインスタンスは、今後のすべての関數(shù)に使用されます。この考え方は、PHP の MySQL 関數(shù)の接続タグに非常に似ています。通常、イベントベースのパーサーでは、ドキュメントを解析する前に、特定のイベントが発生したときに呼び出されるコールバック関數(shù)を登録する必要があります。 Expat には例外イベントはなく、次の 7 つの可能なイベントが定義されています:


オブジェクト XML 解析関數(shù) 説明

要素 xml_set_element_handler() 要素の開始と終了

文字データ
処理命令 xml_set_processing_instruction_handler() 処理命令の発生

表記法宣言の発生 xml_set_notation_decl_handler() 表記法宣言の発生

デフォルト xml_set_default_handler() 指定されていないその他のイベントハンドラー

すべてのコールバック関數(shù)は、最初のパラメーターとしてパーサーのインスタンスを取る必要があります (他のパラメーターもあります)。


サンプル スクリプトについては、この記事の最後にあります。注意が必要なのは、要素処理関數(shù)と文字データ処理関數(shù)の両方を使用していることです。要素のコールバック ハンドラー関數(shù)は、xml_set_element_handler() を通じて登録されます。


この関數(shù)には 3 つのパラメータが必要です:

パーサーのインスタンス
開始要素を処理するコールバック関數(shù)の名前
終了要素を処理するコールバック関數(shù)の名前
コールバック関數(shù)は、解析を開始するときに存在する必要がありますXML ドキュメント。これらは、PHP マニュアルに記載されているプロトタイプと一致して定義する必要があります。


たとえば、Expat は開始要素のハンドラー関數(shù)に 3 つのパラメーターを渡します。スクリプト例では、次のように定義されています:


function start_element($parser, $name, $attrs)


最初のパラメータはパーサー識別子、2 番目のパラメータは開始要素の名前、 3 番目のパラメータは、要素のすべての屬性と値を含む配列です。


XML ドキュメントの解析を開始すると、Expat は開始要素に遭遇するたびに start_element() 関數(shù)を呼び出してパラメーターを渡します。


XML 大文字と小文字の折り畳みオプション

xml_parser_set_option() 関數(shù)を使用して、大文字と小文字の折り畳みオプションをオフにします。このオプションはデフォルトでオンになっており、ハンドラー関數(shù)に渡される要素名が自動的に大文字に変換されます。ただし、XML では大文字と小文字が區(qū)別されます (したがって、統(tǒng)計 XML ドキュメントでは大文字と小文字が非常に重要です)。この例では、ケース折りたたみオプションをオフにする必要があります。


ドキュメントを解析する

すべての準(zhǔn)備作業(yè)が完了したら、スクリプトは最終的に XML ドキュメントを解析できるようになります: カスタム関數(shù)

Xml_parse_from_file() は、パラメータで指定されたファイルを開き、サイズ 4kb で解析します
xml_parse() は、xml_parse_from_file() と同様、エラーが発生した場合、つまり XML ドキュメントが完全にフォーマットされていない場合に false を返します。
xml_get_error_code() 関數(shù)を使用して、最後のエラーの數(shù)値コードを取得できます。この數(shù)値コードを xml_error_string() 関數(shù)に渡して、エラー テキスト情報を取得します。
XML の現(xiàn)在の行番號を出力し、デバッグを容易にします。
解析プロセス中に、コールバック関數(shù)が呼び出されます。
文書構(gòu)造を説明する

文書を解析するとき、Expat が強(qiáng)調(diào)する必要がある問題は、「文書構(gòu)造の基本的な説明をどのように維持するか?」ということです。


前に述べたように、イベントベースのパーサー自體は構(gòu)造情報を生成しません。


ただし、タグ構(gòu)造は XML の重要な機(jī)能です。たとえば、要素シーケンス の場合、スタックは次のように埋められます:

開始要素 book: スタックの最初の要素に "book" を割り當(dāng)てます ( $スタック[0])。
開始要素 title: スタックの先頭 ($stack[1]) に「title」を割り當(dāng)てます。
要素タイトルの終了: スタック ($stack[1]) から最上位の要素を削除します。
要素タイトルの終了: スタック ($stack[0]) から最上位の要素を削除します。
PHP3.0 は、$ Depth 変數(shù)を通じて要素のネストを手動で制御することにより、この例を?qū)g裝します。これにより、スクリプトがより複雑に見えます。 PHP4.0 では、array_pop() 関數(shù)と array_push() 関數(shù)を使用して、スクリプトをより簡潔に見せます。


データを収集する

各要素に関する情報を収集するには、スクリプトは各要素のイベントを記憶する必要があります。グローバル配列変數(shù) $elements を使用して、ドキュメント內(nèi)のさまざまな要素をすべて保存します。配列の項目は要素クラスのインスタンスであり、4 つの屬性 (クラスの変數(shù)) を持ちます。

$count - 要素がドキュメント內(nèi)で見つかった回數(shù)
$chars - ドキュメント內(nèi)の文字イベントのバイト數(shù)要素
$parents - 親要素
$childs - 子要素
ご覧のとおり、クラス インスタンスを配列に保存するのは簡単です。


注: PHP の機(jī)能の 1 つは、対応する配列全體を走査するのと同じように、while(list() = each()) ループを通じてクラス構(gòu)造全體を走査できることです。すべてのクラス変數(shù) (および PHP3.0 を使用する場合はメソッド名) は文字列として出力されます。


要素が見つかったら、ドキュメント內(nèi)でその要素が何回出現(xiàn)したかを追跡するために、対応するカウンターをインクリメントする必要があります。対応する $elements 項目の count 要素も 1 つ増加します。


また、現(xiàn)在の要素がその子要素であることを親要素に知らせる必要があります。したがって、現(xiàn)在の要素の名前は、親要素の $childs 配列內(nèi)の項目に追加されます。最後に、現(xiàn)在の要素はその親が誰であるかを記憶する必要があります。したがって、親要素は、現(xiàn)在の要素の $parents 配列內(nèi)の項目に追加されます。


統(tǒng)計の表示

殘りのコードは、$elements 配列とそのサブ配列をループして、統(tǒng)計結(jié)果を表示します。これは最も単純なネストされたループですが、正しい結(jié)果が出力されますが、コードは簡潔でも特別なスキルもありません。これは、作業(yè)を完了するために毎日使用できる?yún)gなるループです。


このスクリプトの例は、PHP の CGI モードのコマンド ラインを通じて呼び出されるように設(shè)計されています。そのため、統(tǒng)計結(jié)果の出力形式はテキスト形式となります。スクリプトをインターネット上で使用する場合は、出力関數(shù)を変更して HTML 形式を生成する必要があります。

概要

Exapt は、PHP 用の XML パーサーです。イベントベースのパーサーとして、文書の構(gòu)造的な記述は生成されません。ただし、低レベルのアクセスを提供することにより、リソースの利用効率が向上し、アクセスが高速化されます。


有効性をチェックしないパーサーとして、Expat は XML 文書に関連付けられた DTD を無視しますが、文書の形式が不完全な場合は、エラー メッセージを表示して停止します。


ドキュメントを処理するためのイベント処理関數(shù)を提供します
スタックやツリーなどの獨(dú)自のイベント構(gòu)造を構(gòu)築して、XML 構(gòu)造情報マークアップの利點(diǎn)を活用します。
新しい XML プログラムが毎日登場し、PHP の XML サポートは常に強(qiáng)化されています (たとえば、DOM ベースの XML パーサー LibXML のサポートが追加されました)。


PHP と Expat を使用すると、有効かつオープンでプラットフォームに依存しない今後の標(biāo)準(zhǔn)に備えることができます。

例

/*************************************************** * *************************
* 名前: XML 解析の例: XML 文書情報統(tǒng)計
* 説明
* この例では、PHP の Expat パーサー Collect を使用しますXML ドキュメント情報 (例: 各要素、親要素、子要素の出現(xiàn)數(shù))
* パラメータとしての XML ファイル。/xmlstats_PHP4.php3 test.xml
* $Requires: Expat Requirements: Expat PHP4.0 コンパイル済みCGI モードへ
********************************************** ******** *******************************/

// 最初のパラメータは XML ファイルです
$file = $argv[1];
$elements = $ stack = array();
$total_elements = $total_chars = 0;

//要素の基本クラス
var $count = 0;
var $parents = array() ;
var $childs = array();
}

// XML ファイルを解析する関數(shù)
function xml_parse_from_file($parser, $file)
{
if(!file_exists($file))
{
die("ファイル "$file" が見つかりません。");
}

if(!($fp = @fopen($file, "r")))
{
die("ファイル "$file" を開けません.");
}

while($data = fread($fp, 4096))
{
if(!xml_parse($parser, $data, feof($fp)))
{
return(false);
}
}

fclose($fp);

return(true);
}

// 出力結(jié)果関數(shù)(ボックス形式)
function print_box($title, $value)
{
printf("n+ % '-60s+n", "");
printf("|%20s", "$title:");
printf("%14s", $value);
printf("%26s|n", " ");
printf("+%'-60s+n", "");
}

// 出力結(jié)果関數(shù)（行形式）
function print_line($title, $value)
{
printf("%20s", "$title:");
printf("%15sn", $value)
}

// 並べ替え関數(shù)
function my_sort($a, $b)
{
return(is_object) ($a) && is_object($b) ? $b->count - $a->count: 0);

function start_element($parser, $name, $attrs)
{
global $elements , $stack;

// 要素は既にグローバル $elements 配列にありますか?
if(!isset($elements[$name]))
{
// いいえ - 要素のクラス インスタンスを追加します
$element = 新しい要素
} // この要素のカウンターは 1 つ増加します
$elements[$name]->count++;

// 親要素はありますか?
if(isset($stack[count($stack)-1]))
{
// はい - 親要素を $last_element に割り當(dāng)てます
$last_element = $stack[count($stack)-1]; // 現(xiàn)在の要素の親要素配列が空の場合、0 に初期化します
if(!isset($elements[$name]->parents[$last_element]))
{
$elements[$name]- >parents [$last_element] = 0;
}

// この要素の親要素カウンターを 1 つ増やします
$elements[$name]->parents[$last_element]++;現(xiàn)在の要素の親要素の子要素の配列は空で、0 に初期化されます

if(!isset($elements[$last_element]->childs[$name]))
{
$elements[$last_element]-> ;childs[$name ] = 0;
}

// 要素の親要素の子要素カウンターに 1 を追加します
$elements[$last_element]->childs[$name]++;

/ / 現(xiàn)在の要素をスタックに追加します
array_push($stack, $name);
}

function stop_element($parser, $name)
{
global $stack; stack
array_pop($stack);
}

function char_data($parser, $data)
{
global $elements, $stack, $ Depth

// 現(xiàn)在の要素の文字?jǐn)?shù)を増やします
$elements; [$stack][ count($stack)-1]]->chars += strlen(trim($data))
}

// パーサーのインスタンスを生成します
$parser = xml_parser_create();
// 処理関數(shù)を設(shè)定します
xml_set_element_handler($parser, "start_element", "stop_element")
xml_set_character_data_handler($parser, "char_data");
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);ファイルを解析する
$ret = xml_parse_from_file($ parser, $file);
if(!$ret)
{
die(sprintf("XML エラー: %s 行 %d",
xml_error_string(xml_get_error_code($parser)),
xml_get_current_line_number($parser))) ;
}

// パーサーを解放します
xml_parser_free($parser);

// ヘルパー要素を解放します
unset($elements["current_element"]); "last_element"]);

// 要素の數(shù)に応じて並べ替えます
uasort($elements, "my_sort");

// $elements の要素情報を収集するループ
while(list($name, $element) ) = each($elements))
{
print_box("要素名", $name);

print_line("要素數(shù)", $element->count);
print_line("文字?jǐn)?shù)", $element-) >chars);

printf(" n%20sn", "* 親要素");

// 要素の親をループし、結(jié)果を出力します
while(list($key, $value) = each ($element->parents))
{
print_line($key, $value);
}
if(count($element->parents) == 0)
{
printf("%35sn", " [ルート要素]");
}

// 要素の子をループして結(jié)果を出力
printf("n%20sn", "* Child elements");
while(list($key, $value) ) = each($element->childs))
{
print_line($key, $value)
}
if(count($element->childs) == 0)
{
printf("%35sn ", "[子供なし]");
}

$total_elements += $element->count;
$total_chars += $element->chars;
}

// 最終結(jié)果
print_box("Total要素", $total_elements);
print_box("合計文字?jǐn)?shù)", $total_chars);??
?>?