PHP Manual
Prev |  | Next

# error_log

error_log -- send an error message somewhere

## Description

`int error_log`(string message, int message_type, string [destination] , string [extra_headers] );

Sends an error message to the web server's error log, a TCP port or to a file. The first parameter, `message`, is the error message that should be logged. The second parameter, `message_type` says where the message should go:

Table 1. error_log() log types

0 | `message` is sent to PHP's system logger, using the Operating System's system logging mechanism or a file, depending on what the error_log configuration directive is set to.
1 | `message` is sent by email to the address in the `destination` parameter. This is the only message type where the fourth parameter, `extra_headers` is used. This message type uses the same internal function as Mail() does.
2 | `message` is sent through the PHP debugging connection. This option is only available if remote debugging has been enabled. In this case, the `destination` parameter specifies the host name or IP address and optionally, port number, of the socket receiving the debug information.
3 | `message` is appended to the file `destination`.

Example 1. error_log() examples
      1
      2 // Send notification through the server log if we can not
      3 // connect to the database.
      4 if (!Ora_Logon($username, $password)) {
      5     error_log("Oracle database not available!", 0);
      6 }
      7
      8 // Notify administrator by email if we run out of FOO
      9 if (!($foo = allocate_new_foo()) {
     10     error_log("Big trouble, we're all out of FOOs!", 1,
     11               "operator@mydomain.com");
     12 }
     13
     14 // other ways of calling error_log():
     15 error_log("You messed up!", 2, "127.0.0.1:7000");
     16 error_log("You messed up!", 2, "loghost");
     17 error_log("You messed up!", 3, "/var/tmp/my-errors.log");
     18

Prev | Home | Next
PHP options & information | Up | error_reporting