Login   Register  
PHP Classes

Log watcher: Watch a log file and e-mail newly added lines

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us

  Author Author  
Picture of Manuel Lemos
Name: Manuel Lemos <contact>
Classes: 38 packages by
Country: Portugal Portugal
Age: 45
All time rank: 1
Week rank: 3 Down1 in Portugal Portugal Equal

  Detailed description   Download Download .zip .tar.gz   Install with Composer Install with Composer  
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.

  Classes of Manuel Lemos  >  Log watcher  >  Download Download .zip .tar.gz  >  Support forum Support forum  >  Blog Blog (1)  >  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
Version: 1.0.0
PHP version: -
License: BSD License
All time users: 4399 users
All time rank: 587
Week users: 0 users
Week rank: 1419 Equal
  Groups   Screenshots Screenshots   Rate classes User ratings   Dependencies  
  Trackback   Applications   Related pages   Files Files  

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  
File Role Description
Accessible without login Image file logwatcher.gif Screen Example of log watching message sent by the class

  User ratings  
RatingsUtility Consistency Documentation Examples Tests Videos Overall Rank
All time: Good (87%) Good (83%) Good (83%) Good (83%) - - Sufficient (68%) 271
Month: Not yet rated by the users

  Packages needed by this class  
Class DownloadWhy it is needed Dependency
MIME E-mail message sending Download .zip .tar.gz When the mail delivery method is meant to replaced by the urgent mail function Optional

  Pages that reference this package  
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...

Latest pages that reference packages Latest pages that reference packages

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

  Related pages  
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

Install with Composer Install with Composer - Download 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.