PHP Function Reference

PHP syslog() Function



The PHP syslog() function generates a system log message.

Syntax

syslog(priority, message)

Parameters

priority Required. It is a combination of the facility and the level. Possible values are (priorities in descending order):
  • LOG_EMERG - system is unusable
  • LOG_ALERT - action must be taken immediately
  • LOG_CRIT - critical conditions
  • LOG_ERR - error conditions
  • LOG_WARNING - warning conditions
  • LOG_NOTICE - normal, but significant, condition
  • LOG_INFO - informational message
  • LOG_DEBUG - debug-level message
message Required. Specify the message to send.

Return Value

Returns true on success or false on failure.

Example:

The example below shows the usage of syslog() function.

<?php
//open syslog, include the process ID and also send the log 
//to standard error, and use a user defined logging mechanism
openlog("myScriptLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);

//code lines

if (authorized_client()) {
  //code lines
} else {
  //unauthorized client! - attempt to log
  $access = date("Y/m/d H:i:s");
  syslog(LOG_WARNING, 
         "Unauthorized client: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");
}

//closing the system logger
closelog();
?>

❮ PHP Network Reference