CoreFiles by mySites.guru
CallbackLogger.php69 lines, 1,723 bytes, from Joomla_4.2.0-Stable-Full_Package.zip
Raw History Compare with 4.1.5
md5
bf4684fa3a6f0f12434bf2283b32bc6a
sha1
9f4f98081511d97019d0c17bf5f248df71f90e78
sha256
f4d11058813141195a9f4e73dc87e78aaf8c24f3f10dbde88bb70776dada663c
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2012 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Log\Logger;

use Joomla\CMS\Log\LogEntry;
use Joomla\CMS\Log\Logger;

/**
 * Joomla! Callback Log class
 *
 * This class allows logging to be handled by a callback function.
 * This allows unprecedented flexibility in the way logging can be handled.
 *
 * @since  3.0.1
 */
class CallbackLogger extends Logger
{
    /**
     * The function to call when an entry is added
     *
     * @var    callable
     * @since  3.0.1
     */
    protected $callback;

    /**
     * Constructor.
     *
     * @param   array  &$options  Log object options.
     *
     * @since   3.0.1
     * @throws  \RuntimeException
     */
    public function __construct(array &$options)
    {
        // Call the parent constructor.
        parent::__construct($options);

        // Throw an exception if there is not a valid callback
        if (!isset($this->options['callback']) || !\is_callable($this->options['callback'])) {
            throw new \RuntimeException(sprintf('%s created without valid callback function.', \get_class($this)));
        }

        $this->callback = $this->options['callback'];
    }

    /**
     * Method to add an entry to the log.
     *
     * @param   LogEntry  $entry  The log entry object to add to the log.
     *
     * @return  void
     *
     * @since   3.0.1
     * @throws  \RuntimeException
     */
    public function addEntry(LogEntry $entry)
    {
        // Pass the log entry to the callback function
        \call_user_func($this->callback, $entry);
    }
}

The same content is in 5 releases, Joomla 4.2.0-beta3 to 4.2.1-rc2. See them all, or every version of this file.