PHPのlibxml_get_errors()関数の使い方を徹底解説

PHPのlibxml_get_errors()関数は、libxmlエラーバッファに格納されたXML処理時のエラー情報を配列として取得するための関数です。DOMDocumentやSimpleXMLなどでXMLを解析する際に発生したエラーを詳細に確認したい場合に活用されます。

基本構文

libxml_get_errors()

パラメータ

• この関数にはパラメータはありません。

戻り値

libxml_get_errors()関数は、LibXMLErrorオブジェクトの配列を返します。libxmlエラーバッファにエラーが1件も存在しない場合は、空の配列が返されます。

各LibXMLErrorオブジェクトには、エラーレベル（level）、エラーコード（code）、エラーメッセージ（message）、発生行番号（line）、発生カラム位置（column）などの詳細情報が含まれており、デバッグ作業に役立ちます。

使用例

以下は、XMLファイルの読み込み時にエラーが発生した場合、その内容を取得して処理するサンプルコードです。

<?php
   // 内部エラーハンドリングを有効化（標準の警告出力を抑制）
   var_dump(libxml_use_internal_errors(true));
   
   $mydoc = new DOMDocument;
   
   if (!$mydoc->load('new.xml')) {
      // エラーを1件ずつ取り出して処理
      foreach (libxml_get_errors() as $error) {
         // ここでエラー内容をログ出力するなど対応を行う
      }
      // 取得後はエラーバッファをクリアしておくのが推奨
      libxml_clear_errors();
   }
?>

ポイント解説

この例では、まずlibxml_use_internal_errors(true)を呼び出して内部エラーハンドリングを有効にしています。これにより、XML解析エラーがPHPの標準警告として画面に出力される代わりに、libxmlのエラーバッファに保存されるようになります。

その後、libxml_get_errors()でバッファ内の全エラーを配列として取得し、foreachループで1件ずつ処理しています。最後にlibxml_clear_errors()を呼び出してバッファをクリアすることで、次回以降の処理に古いエラー情報が残らないようにしています。

関連する関数

• libxml_use_internal_errors()：内部エラーハンドリングの有効・無効を切り替える

• libxml_clear_errors()：libxmlエラーバッファをクリアする

• libxml_get_last_error()：直近のエラーのみを1件取得する