libxml_use_internal_errors

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

libxml_use_internal_errors Disable libxml errors and allow user to fetch error information as needed

Description

libxml_use_internal_errors(?bool $use_errors = null): bool

libxml_use_internal_errors() allows you to disable standard libxml errors and enable user error handling.

Parameters

use_errors

Enable (true) user error handling or disable (false) user error handling. Disabling will also clear any existing libxml errors.

Return Values

This function returns the previous value of use_errors.

Changelog

Version Description
8.0.0 use_errors is nullable now. Previously, its default was false.

Examples

Example #1 A libxml_use_internal_errors() example

This example demonstrates the basic usage of libxml errors and the value returned by this function.

<?php

// enable user error handling
var_dump(libxml_use_internal_errors(true));

// load the document
$doc = new DOMDocument;

if (!
$doc->load('file.xml')) {
foreach (
libxml_get_errors() as $error) {
// handle errors here
}

libxml_clear_errors();
}

?>

The above example will output:

bool(false)

See Also

add a note add a note

User Contributed Notes 3 notes

up
22
B Crawford
17 years ago
When using this funtion, be sure to clear your internal error buffer. If you dn't and you are using this in a long running process, you may find that all your memory is used up.
up
6
marcovtwout
11 years ago
When using libxml_use_internal_errors(true), and perform a possibly memory intensive operation like simplexml_load_string() next, you might end up with a blank screen and no php error logged because the error message been suppressed.
up
-8
james at dunmore dot me dot uk
16 years ago
We use a custom error handler using  set_error_handler()  I found that after I call

libxml_use_internal_errors(false);

It resets my error_handler - not sure if this is a bug or not, I will report it as a bug - however, I needed to repeat my call to set_error_handler

(did confuse me for a while)
To Top