SYSLOG(3) 1 SYSLOG(3)
syslog - Generate a system log message
SYNOPSIS
bool syslog (int $priority, string $message)
DESCRIPTION
syslog(3) generates a log message that will be distributed by the system logger.
For information on setting up a user defined log handler, see the syslog.conf(5) Unix manual page. More information on the syslog facili-
ties and option can be found in the man pages for syslog(3) on Unix machines.
PARAMETERS
o $priority
-$priority is a combination of the facility and the level. Possible values are:
syslog(3) Priorities (in descending order)
+------------+------------------------------------+
| Constant | |
| | |
| | Description |
| | |
+------------+------------------------------------+
| | |
| 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 |
| | |
+------------+------------------------------------+
o $message
- The message to send, except that the two characters %m will be replaced by the error message string (strerror) corresponding to
the present value of errno.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
Using syslog(3)
<?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);
// some code
if (authorized_client()) {
// do something
} else {
// unauthorized client!
// log the attempt
$access = date("Y/m/d H:i:s");
syslog(LOG_WARNING, "Unauthorized client: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");
}
closelog();
?>
NOTES
On Windows NT, the syslog service is emulated using the Event Log.
Note
Use of LOG_LOCAL0 through LOG_LOCAL7 for the $facility parameter of openlog(3) is not available in Windows.
SEE ALSO
openlog(3), closelog(3).
PHP Documentation Group SYSLOG(3)
