Using Different Loggers In Phing

17th November 2009

When you run a phing script it will print things out to the console. These messages are either system messages (eg. BUILD STARTED) or echo messages that you have put into your build.xml file. All of this output is controlled and created by a logger file. The default logger is called (unsuprsingly) DefaultLogger and will be used as a default. There are a few different types of logger available, all of which can be found in the listener folder in your PEAR\phing directory.

To select a different logger script to be used just use the -logger flag in your phing call. To specify the DefaultLogger use the following:

phing -logger phing.listener.DefaultLogger

To specify an XML logger that will create an XML document of the phing events that occurred in the current working directory use the XmlLogger logger.

phing -logger phing.listener.XmlLogger

So what happens if we want to print out only the echo messages in our build file? There isn't a logger we can use to do this so the solution it to simply make our own. The following code block contains a logger that will only print out echo commands along with any errors that occurred and the time taken for the build to complete. Create a file called EchoLogger.php and put it into the PEAR\phing\listener directory. Many of the comments in this file are from DefaultLogger, I have just changed the parts that were different or not applicable.

  1. PROJECT_MSG_VERBOSE.
  2. * @var int
  3. */
  4. protected $msgOutputLevel = PROJECT_MSG_ERR;
  5.  
  6. /**
  7.   * Time that the build started
  8.   * @var int
  9.   */
  10. protected $startTime;
  11.  
  12. /**
  13.   * Char that should be used to seperate lines. Default is the system
  14.   * property line.seperator.
  15.   * @var string
  16.   */
  17. protected $lSep;
  18.  
  19. /**
  20.   * Construct a new default logger.
  21.   */
  22. public function __construct() {
  23. $this->lSep = Phing::getProperty("line.separator");
  24. }
  25.  
  26. /**
  27.   * Set the msgOutputLevel this logger is to respond to.
  28.   *
  29.   * Only messages with a message level lower than or equal to the given
  30.   * level are output to the log.
  31.   *
  32.   * Constants for the message levels are in Project.php. The order of
  33.   * the levels, from least to most verbose, is:
  34.   *
  35.   *
    *
  • PROJECT_MSG_ERR
  • *
  • PROJECT_MSG_WARN
  • *
  • PROJECT_MSG_INFO
  • *
  • PROJECT_MSG_VERBOSE
  • *
  • PROJECT_MSG_DEBUG
  • *
* * The default message level for DefaultLogger is PROJECT_MSG_ERR. * * @param integer the logging level for the logger. * @access public */ function setMessageOutputLevel($level) { $this->msgOutputLevel = (int) $level; } /** * Sets the start-time when the build started. Used for calculating * the build-time. * * @param object The BuildEvent * @access public */ function buildStarted(BuildEvent $event) { $this->startTime = Phing::currentTimeMillis(); } /** * Prints whether the build failed, and any errors that occured during the build. Also outputs the total build-time on completion. * * @param object The BuildEvent * @access public * @see BuildEvent::getException() */ function buildFinished(BuildEvent $event) { $error = $event->getException(); if ($error !== null) { print($this->lSep . "BUILD FAILED" . $this->lSep); if (PROJECT_MSG_VERBOSE msgOutputLevel || !($error instanceof BuildException)) { print($error->__toString().$this->lSep); } else { print($error->getMessage()); } } print($this->lSep . "Total time: " .$this->_formatTime(Phing::currentTimeMillis() - $this->startTime) . $this->lSep); } /** * Fired when a target has started. We don't need specific action on this * event. So the methods are empty. * * @param object The BuildEvent * @access public * @see BuildEvent::getTarget() */ function targetStarted(BuildEvent $event) {} /** * Fired when a target has finished. We don't need specific action on this * event. So the methods are empty. * * @param object The BuildEvent * @access public * @see BuildEvent::getException() */ function targetFinished(BuildEvent $event) {} /** * Fired when a task is started. We don't need specific action on this * event. So the methods are empty. * * @param object The BuildEvent * @access public * @see BuildEvent::getTask() */ function taskStarted(BuildEvent $event) {} /** * Fired when a task has finished. We don't need specific action on this * event. So the methods are empty. * * @param object The BuildEvent * @access public * @see BuildEvent::getException() */ function taskFinished(BuildEvent $event) {} /** * Print any echo messages to the stdout. * * @param object The BuildEvent * @access public * @see BuildEvent::getMessage() */ function messageLogged(BuildEvent $event) { if ($event->getPriority() msgOutputLevel) { $msg = ""; if ($event->getTask() !== null) { $name = $event->getTask(); $name = $name->getTaskName(); if ($name == 'echo') { $msg = "[$name] "; $msg .= $event->getMessage(); $this->printMessage($msg, $event->getPriority()); } } } } /** * Formats a time micro integer to human readable format. * * @param integer The time stamp * @access private */ function _formatTime($micros) { $seconds = $micros; $minutes = $seconds / 60; if ($minutes > 1) { return sprintf("%1.0f minute%s %0.2f second%s", $minutes, ($minutes === 1 ? " " : "s "), $seconds - floor($seconds/60) * 60, ($seconds%60 === 1 ? "" : "s")); } else { return sprintf("%0.4f second%s", $seconds, ($seconds%60 === 1 ? "" : "s")); } } /** * Prints a message to console. * * @param string $message The message to print. * Should not be null. * @param int $priority The priority of the message. * (Ignored in this implementation.) * @return void */ protected function printMessage($message, $priority) { print($message . $this->lSep); } }

You can now call your new logger by using the following command.

phing -logger phing.listener.EchoLogger

Only echo commands will be printed out, along with the time the script took to run. If any errors are encountered these will be printed in the normal way.

Add new comment

The content of this field is kept private and will not be shown publicly.