Login   Register  
PHP Classes
elePHPant
Icontem

Log watcher

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Classes of Manuel Lemos  >  Log watcher  >  Download .tar.gz .zip  >  Support forum Support forum  >  Blog Blog  >  RSS 1.0 feed RSS 2.0 feed Latest changes  
Name: Log watcher
Base name: logwatcher
Description: Watch a log file and e-mail newly added lines
Related classes: , , , , , , ,
Version: -
PHP version: -
License: BSD License
All time users: 4036 users
All time rank: 612
Week users: 1 user
Week rank: 2417
 

  Author  
Picture of Manuel Lemos
Name: Manuel Lemos <e-mail contact>
Packages: 32 Browse all classes by Manuel Lemos Browse all classes by
Country: Portugal Portugal - PHP jobs in Portugal
Age: 43
All time rank: 1
Week rank: 4 Down1 in Portugal Portugal Equal


  Detailed description  
This class is meant to poll log files and take any newly added lines and send them to a given watcher e-mail address.

Although this class can be used to poll any type of log files, it was developed with the intention to overcome a limitation of the PHP error trapping system that is not able to capture certain types of errors like script parsing errors or file upload failures. Despite of this, these errors are sent to a log file if error logging is enabled in the PHP configuration.

The goal of this class is to capture the error messages sent to log files and send them by e-mail to a person responsible for a site, so any necessary action may be taken with minimal delay.

To use this class to watch the PHP error log, take the example script and adjust any values to match your PHP configuration.

For security reasons, in a production environment, you are strongly encouraged disable displaying PHP errors on Web pages and enable logging errors to a log file. A sample php.ini configuration file is provided to indicate which options should be set in a production environment.

  Groups   Screenshots Screenshots   Freshmeat project   Rate classes User ratings  
  Dependencies   Trackback   Applications   Related links   Files Files  

  Groups  
Group folder image Logging Log generation and processing View top rated classes
Group folder image Security Security protection and attack detection View top rated classes

  Files folder image Screenshots  
Example of log watching message sent by the class
File Role Description
Accessible without login Image file logwatcher.gif Screen Example of log watching message sent by the class


  Freshmeat project  
Log watcher
Project record: logwatcher
Popularity score: 72.71
Vitality score: 2.33

  User ratings  
Ratings
Utility
Consistency
Documentation
Examples
Tests
Videos
Overall
Rank
All time:
Good (87.5%)
Good (83.3%)
Good (83.3%)
Good (83.3%)
-
-
Sufficient (68.7%)
253
Month:
Not yet rated by the users

  Packages needed by this class  
Class Dependency Why it is needed
MIME E-mail message sending
Optional
When the mail delivery method is meant to replaced by the urgent mail function

  Trackback links  
Link Description
How do you handle the E_NOTICE error in PHP? Sure, all errors should be enabled even in production, except maybe for E_STRICT which is usually a bit too pedantic...

  Applications that use this class  
No application links were specified for this class.
Add link image If you know an application of this package, send a message to the author to add a link here.

  Related links  
Link Description
PHP error handling Documentation on the PHP manual about error handling and logging

  Files folder image Files  
File Role Description
Accessible without login Plain text file error_handler.php Aux. Example of an error handler function that logs the error message, the file name, line number, function name, class name, including backtrace of all the function calls that lead to the line where the error occurred.
Accessible without login HTML file log_watcher_class.html Doc. Class documentation extracted from inline meta-document comments
Plain text file log_watcher_class.php Class Log watcher class
Accessible without login Plain text file php.ini Data Sample PHP configuration with options set for maximum logging security in a production environment
Accessible without login Plain text file php_error_log.crontab Data Example of crontab line to execute the example log script to watch the PHP error log
Accessible without login Plain text file test_log_watcher.php Example Example of how to setup the class to watch a given log file, e-mail the newly added lines, if any, and exit

Download all files: logwatcher.tar.gz logwatcher.zip
NOTICE: if you are using a download manager program like 'GetRight', please Login before trying to download this archive.