PHPのlibxml_use_internal_errors()関数とは？使い方をわかりやすく解説

PHPのlibxml_use_internal_errors()関数は、libxmlが標準で出力するエラー表示を無効にし、代わりにユーザー側で必要なタイミングに合わせてエラー情報を取得・処理できるようにするための関数です。

XMLやHTMLの解析時に発生したエラーを画面にそのまま出力せず、プログラム内で柔軟にハンドリングしたい場合に非常に便利です。

構文

libxml_use_internal_errors(err)

パラメータ

• err − ユーザーによるエラーハンドリングを有効にするかどうかを指定します。デフォルト値はFALSEです。

戻り値

libxml_use_internal_errors()関数は、呼び出し前におけるerrパラメータ（内部エラーハンドリング設定）の値を返します。これにより、処理後に元の設定へ復元することも可能です。

使用例

以下は、libxml_use_internal_errors()関数を使用してXMLファイル読み込み時のエラーを独自に処理する例です。

<?php
   var_dump(libxml_use_internal_errors(true));
   $mydoc = new DOMDocument;
   if (!$mydoc->load('new.xml')) {
      foreach (libxml_get_errors() as $error) {
         // エラーをここで処理する
      }
      libxml_clear_errors();
   }
?>

この例では、まずlibxml_use_internal_errors(true)を呼び出して内部エラーハンドリングを有効にしています。その後、DOMDocumentでnew.xmlを読み込み、失敗した場合にはlibxml_get_errors()でエラー一覧を取得し、個別に処理を行います。最後にlibxml_clear_errors()でエラーのバッファをクリアしている点もポイントです。