PHP Classes

File: syslog.php

Recommend this page to a friend!
  Classes of André Liechti   Pure PHP syslog client   syslog.php   Download  
File: syslog.php
Role: Class source
Content type: text/plain
Description: Syslog class
Class: Pure PHP syslog client
Log data to a RFC 3164 compliant syslog server
Author: By
Last change: Typo
Date: 18 years ago
Size: 11,941 bytes
 

Contents

Class file image Download
<?php /********************************************************************* * * $HeadURL: syslog.php $ * $LastChangedRevision: 1.1 $ * Language: PHP 4.x or higher * Copyright: SysCo systèmes de communication sa * CreationDate: 2005-11-05 * CreatedBy: SysCo/al * $LastChangedDate: 2005-12-24 $ * $LastChangedBy: SysCo/al $ * WebSite: http://developer.sysco.ch/php/ * Email: developer [at] sysco [dot] ch * * * Description * * The Syslog class is a syslog device implementation in PHP * following the RFC 3164 rules. * * Facility values: * 0 kernel messages * 1 user-level messages * 2 mail system * 3 system daemons * 4 security/authorization messages * 5 messages generated internally by syslogd * 6 line printer subsystem * 7 network news subsystem * 8 UUCP subsystem * 9 clock daemon * 10 security/authorization messages * 11 FTP daemon * 12 NTP subsystem * 13 log audit * 14 log alert * 15 clock daemon * 16 local user 0 (local0) (default value) * 17 local user 1 (local1) * 18 local user 2 (local2) * 19 local user 3 (local3) * 20 local user 4 (local4) * 21 local user 5 (local5) * 22 local user 6 (local6) * 23 local user 7 (local7) * * Severity values: * 0 Emergency: system is unusable * 1 Alert: action must be taken immediately * 2 Critical: critical conditions * 3 Error: error conditions * 4 Warning: warning conditions * 5 Notice: normal but significant condition (default value) * 6 Informational: informational messages * 7 Debug: debug-level messages * * * Usage * * require_once('syslog.php'); * $syslog = new Syslog($facility = 16, $severity = 5, $hostname = "", $fqdn= "", $ip_from = "", $process="", $content = ""); * $syslog->Send($server = "", $content = "", $timeout = 0); * * * Examples * * Example 1 * <?php * require_once('syslog.php'); * $syslog = new Syslog(); * $syslog->Send('192.168.0.12', 'My first PHP syslog message'); * ?> * * Example 2 * <?php * require_once('syslog.php'); * $syslog = new Syslog(23, 7, 'MYSERVER', 'myserver.mydomain.net', '192.168.0.1', 'webautomation'); * $syslog->Send('192.168.0.12', 'My second PHP syslog message'); * ?> * * Example 3 * <?php * require_once('syslog.php'); * $syslog = new Syslog(); * $syslog->SetFacility(23); * $syslog->SetSeverity(7); * $syslog->SetHostname('MYSERVER'); * $syslog->SetFqdn('myserver.mydomain.net'); * $syslog->SetIpFrom('192.168.0.1'); * $syslog->SetProcess('webautomation'); * $syslog->SetContent('My third PHP syslog message'); * $syslog->SetServer('192.168.0.12'); * $syslog->Send(); * ?> * * Example 4 * <?php * // Do not follow the conventions of the RFC * // and send a customized MSG part instead of * // the recommanded format "process fqdn ip content" * require_once('syslog.php'); * $syslog = new Syslog(); * $syslog->SetFacility(23); * $syslog->SetSeverity(7); * $syslog->SetHostname('MYSERVER'); * $syslog->SetMsg('My customized MSG PHP syslog message'); * $syslog->SetServer('192.168.0.12'); * $syslog->Send(); * ?> * * * External file needed * * none. * * * External file created * * none. * * * Special issues * * - Sockets support must be enabled. * * In Linux and *nix environments, the extension is enabled at * compile time using the --enable-sockets configure option * * In Windows, PHP Sockets can be activated by un-commenting * extension=php_sockets.dll in php.ini * * * Licence * * Copyright (c) 2005, SysCo systèmes de communication sa * SysCo (tm) is a trademark of SysCo systèmes de communication sa * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither the name of SysCo systèmes de communication sa nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT * SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * * Change Log * * 2005-12-24 1.1 SysCo/al Generic release and documentation * 2005-11-05 1.0 SysCo/al Initial release * *********************************************************************/ class Syslog { var $_facility; // 0-23 var $_severity; // 0-7 var $_hostname; // no embedded space, no domain name, only a-z A-Z 0-9 and other authorized characters var $_fqdn; var $_ip_from; var $_process; var $_content; var $_msg; var $_server; // Syslog destination server var $_port; // Standard syslog port is 514 var $_timeout; // Timeout of the UDP connection (in seconds) function Syslog($facility = 16, $severity = 5, $hostname = "", $fqdn= "", $ip_from = "", $process="", $content = "") { $this->_msg = ''; $this->_server = '127.0.0.1'; $this->_port = 514; $this->_timeout = 10; $this->_facility = $facility; $this->_severity = $severity; $this->_hostname = $hostname; if ($this->_hostname == "") { if (isset($_ENV["COMPUTERNAME"])) { $this->_hostname = $_ENV["COMPUTERNAME"]; } elseif (isset($_ENV["HOSTNAME"])) { $this->_hostname = $_ENV["HOSTNAME"]; } else { $this->_hostname = "WEBSERVER"; } } $this->_hostname = substr($this->_hostname, 0, strpos($this->_hostname.".", ".")); $this->_fqdn = $fqdn; if ($this->_fqdn == "") { if (isset($_SERVER["SERVER_NAME"])) { $this->_fqdn = $_SERVER["SERVER_NAME"]; } } $this->_ip_from = $ip_from; if ($this->_ip_from == "") { if (isset($_SERVER["SERVER_ADDR"])) { $this->_ip_from = $_SERVER["SERVER_ADDR"]; } } $this->_process = $process; if ($this->_process == "") { $this->_process = "PHP"; } $this->_content = $content; if ($this->_content == "") { $this->_content = "PHP generated message"; } } function SetFacility($facility) { $this->_facility = $facility; } function SetSeverity($severity) { $this->_severity = $severity; } function SetHostname($hostname) { $this->_hostname = $hostname; } function SetFqdn($fqdn) { $this->_fqdn = $fqdn; } function SetIpFrom($ip_from) { $this->_ip_from = $ip_from; } function SetProcess($process) { $this->_process = $process; } function SetContent($content) { $this->_content = $content; } function SetMsg($msg) { $this->_msg = $msg; } function SetServer($server) { $this->_server = $server; } function SetPort($port) { if ((intval($port) > 0) && (intval($port) < 65536)) { $this->_port = intval($port); } } function SetTimeout($timeout) { if (intval($timeout) > 0) { $this->_timeout = intval($timeout); } } function Send($server = "", $content = "", $timeout = 0) { if ($server != "") { $this->_server = $server; } if ($content != "") { $this->_content = $content; } if (intval($timeout) > 0) { $this->_timeout = intval($timeout); } if ($this->_facility < 0) { $this->_facility = 0; } if ($this->_facility > 23) { $this->_facility = 23; } if ($this->_severity < 0) { $this->_severity = 0; } if ($this->_severity > 7) { $this->_severity = 7; } $this->_process = substr($this->_process, 0, 32); $actualtime = time(); $month = date("M", $actualtime); $day = substr(" ".date("j", $actualtime), -2); $hhmmss = date("H:i:s", $actualtime); $timestamp = $month." ".$day." ".$hhmmss; $pri = "<".($this->_facility*8 + $this->_severity).">"; $header = $timestamp." ".$this->_hostname; if ($this->_msg != "") { $msg = $this->_msg; } else { $msg = $this->_process.": ".$this->_fqdn." ".$this->_ip_from." ".$this->_content; } $message = substr($pri.$header." ".$msg, 0, 1024); $fp = fsockopen("udp://".$this->_server, $this->_port, $errno, $errstr); if ($fp) { fwrite($fp, $message); fclose($fp); $result = $message; } else { $result = "ERROR: $errno - $errstr"; } return $result; } } ?>