PHP set_error_handler() Function

|  | Search W3Schools : |

HOME | HTML | CSS | XML | JAVASCRIPT | ASP | PHP | SQL | MORE... |  | References | Examples | Forum | About

ADVERTISEMENTS XML Certification Download XML editor Custom Programming |  |

Table of contents

PHP Basic
PHP HOME
PHP Intro
PHP Install
PHP Syntax
PHP Variables
PHP String
PHP Operators
PHP If...Else
PHP Switch
PHP Arrays
PHP Looping
PHP Functions
PHP Forms
PHP $_GET
PHP $_POST
PHP Advanced
PHP Date
PHP Include
PHP File
PHP File Upload
PHP Cookies
PHP Sessions
PHP E-mail
PHP Secure E-mail
PHP Error
PHP Exception
PHP Filter
PHP Database
MySQL Introduction
MySQL Connect
MySQL Create
MySQL Insert
MySQL Select
MySQL Where
MySQL Order By
MySQL Update
MySQL Delete
PHP ODBC
PHP XML
XML Expat Parser
XML DOM
XML SimpleXML
PHP and AJAX
AJAX Introduction
XMLHttpRequest
AJAX Suggest
AJAX XML
AJAX Database
AJAX responseXML
AJAX Live Search
AJAX RSS Reader
AJAX Poll
PHP Reference
PHP Array
PHP Calendar
PHP Date
PHP Directory
PHP Error
PHP Filesystem
PHP Filter
PHP FTP
PHP HTTP
PHP Libxml
PHP Mail
PHP Math
PHP Misc
PHP MySQL
PHP SimpleXML
PHP String
PHP XML
PHP Zip
PHP Quiz
PHP Quiz
PHP Exam

Selected Reading

Web Statistics
Web Glossary
Web Hosting
Web Quality
W3Schools Tutorials
W3Schools Forum
Helping W3Schools

# PHP set_error_handler() Function

Complete PHP Error Reference

## Definition and Usage

The set_error_handler() function sets a user-defined function to handle errors.

This function is used to create your own way of handling errors during runtime.

This function returns the old error handler, or NULL on failure.

## Syntax

    set_error_handler(error_function,error_types)

Parameter | Description
--- | ---
error_function | Required. Specifies the function to be run at errors
error_types | Optional. Specifies on which errors report levels the user-defined error will be shown. Default is "E_ALL". See table below for possible error report levels

## error_function

## Syntax

    error_function(error_level,error_message,
    error_file,error_line,error_context)

Parameter | Description
--- | ---
error_level | Required. Specifies the error report level for the user-defined error. Must be a value number. See table below for possible error report levels
error_message | Required. Specifies the error message for the user-defined error
error_file | Optional. Specifies the filename in which the error occurred
error_line | Optional. Specifies the line number in which the error occurred
error_context | Optional. Specifies an array that points to the active symbol table at the point the error occurred. In other words, error_context will contain an array of every variable that existed in the scope the error was triggered in

## Error Report levels

Value | Constant | Description
--- | --- | ---
2 | E_WARNING | Non-fatal run-time errors. Execution of the script is not halted
8 | E_NOTICE | Run-time notices. The script found something that might be an error, but could also happen when running a script normally
256 | E_USER_ERROR | Fatal user-generated error. This is like an E_ERROR set by the programmer using the PHP function trigger_error()
512 | E_USER_WARNING | Non-fatal user-generated warning. This is like an E_WARNING set by the programmer using the PHP function trigger_error()
1024 | E_USER_NOTICE | User-generated notice. This is like an E_NOTICE set by the programmer using the PHP function trigger_error()
4096 | E_RECOVERABLE_ERROR | Catchable fatal error. This is like an E_ERROR but can be caught by a user defined handle (see also set_error_handler())
8191 | E_ALL | All errors and warnings, except level E_STRICT (E_STRICT will be part of E_ALL as of PHP 6.0)

## Tips and Notes

Tip: The standard PHP error handler is completely bypassed if this function is used, and the user-defined error handler must terminate the script (die() ) if necessary
Note: If errors occur before the script is executed the custom error handler cannot be used since it is not registered at that time

## Example

    <?php
    //error handler function
    function customError($errno, $errstr, $errfile, $errline)
     {
     echo "<b>Custom error:</b> [$errno] $errstr<br />";
     echo " Error on line $errline in $errfile<br />";
     echo "Ending Script";
     die();
     }

    //set error handler
    set_error_handler("customError");

    $test=2;

    //trigger error
    if ($test>1)
     {
     trigger_error("A custom error has been triggered");
     }
    ?>

The output of the code above should be something like this:

    Custom error: [1024] A custom error has been triggered
    Error on line 19 in C:\webfolder\test.php
    Ending Script

Complete PHP Error Reference

## Altova® XMLSpy® - The world's best-selling XML editor!

Whether you're new to XML or already an advanced user, the user-friendly views and powerful entry helpers, wizards, and debuggers in XMLSpy are designed to meet your XML and Web services development needs from start to finish.

- XML editor
- Graphical XML Schema / DTD editors
- XSLT 1.0/2.0 editor, debugger, profiler
- XQuery editor, debugger, profiler
- Support for Office Open XML (OOXML)
- Graphical WSDL editor & SOAP debugger
- Java, C#, C++ code generation
- And much more!

Download a fully functional free 30-day trial today!

WEB HOSTING
ASP.NET Shopping Cart
$15 Domain Name Registration Save $20 / year!
Buy UK Domain Names Register Domain Names
Cheap Domain Names Cheap Web Hosting
Best Web Hosting
PHP MySQL Hosting
Top 10 Web Hosting
UK Reseller Hosting
Web Hosting
FREE Web Hosting

WEB BUILDING
Website Templates Flash Templates Website Builder Internet Business Opportunity
Custom Programming
FREE Trial or Demo Web Content Manager Forms,Web Alerts,RSS
Download XML editor
FREE Flash Website
FREE Web Templates

EDUCATION
US Web Design Schools
HTML Certification
JavaScript Certification
XML Certification
PHP Certification
ASP Certification

HOME or Top of Page |  | Printer Friendly
W3Schools is for training only. We do not warrant the correctness of its content. The risk from using it lies entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy. Copyright 1999-2009 by Refsnes Data. All Rights Reserved.