Logger::error() - Code Metrics - appserver-io/logger - Measure and Improve Code Quality continuously with Scrutinizer

Logger::error() A
last analyzed 2018-06-19 19:24 UTC

↳ Parent: Logger

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes

Metric	Value
dl	0
loc	4
c	0
b	0
f	0
ccs	0
cts	3
cp	0
rs	10
cc	1
eloc	2
nc	1
nop	2
crap	2

<?php

/**
 * AppserverIo\Logger\Logger
 *
 * NOTICE OF LICENSE
 *
 * This source file is subject to the Open Software License (OSL 3.0)
 * that is available through the world-wide-web at this URL:
 * http://opensource.org/licenses/osl-3.0.php
 *
 * PHP version 5
 *
 * @author    Tim Wagner <[email protected]>
 * @copyright 2015 TechDivision GmbH <[email protected]>
 * @license   http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
 * @link      http://github.com/appserver-io/logger
 * @link      http://www.appserver.io
 */

namespace AppserverIo\Logger;

use Psr\Log\LogLevel;
use AppserverIo\Logger\Handlers\HandlerInterface;
use AppserverIo\Logger\Processors\ProcessorInterface;

/**
 * Thread-Safe and PSR-3 compatible logger implementation.
 *
 * @author    Tim Wagner <[email protected]>
 * @copyright 2015 TechDivision GmbH <[email protected]>
 * @license   http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
 * @link      http://github.com/appserver-io/logger
 * @link      http://www.appserver.io
 */
class Logger implements ThreadSafeLoggerInterface
{

    /**
     * The thread context of the thread we're logging for.
     *
     * @var string
     */
    public static $threadContext = 'global';

    /**
     * The channel name we log to.
     *
     * @var string
     */
    protected $channelName;

    /**
     * Array with the handlers.
     *
     * @var array
     */
    protected $handlers;

    /**
     * Array with the processors.
     *
     * @var array
     */
    protected $processors;

    /**
     * Initializes the logger instance with the log level.
     *
     * @param string $channelName The channel name
     * @param array  $handlers    The array with the handlers
     * @param array  $processors  The array with the processors
     */
    public function __construct($channelName, array $handlers = array(), array $processors = array())
    {

        // initialize the passe values
        $this->channelName = $channelName;

        // initialize the stackables
        $this->handlers = array();
        $this->processors = array();

        // add the passed handlers
        foreach ($handlers as $handler) {
            $this->addHandler($handler);
        }

        // add the passed processors
        foreach ($processors as $processor) {
            $this->addProcessor($processor);
        }
    }

    /**
     * Adds the passed handler.
     *
     * @param \AppserverIo\Logger\Handlers\HandlerInterface $handler The handler to be added
     *
     * @return void
     */
    public function addHandler(HandlerInterface $handler)
    {
        $this->handlers[] = $handler;
    }

    /**
     * Returns the registered handlers.
     *
     * @return \Stackable The registered handlers
     */
    protected function getHandlers()
    {
        return $this->handlers;
    }

    /**
     * Adds the passed processor.
     *
     * @param \AppserverIo\Logger\Processors\ProcessorInterface $processor The processor to be added
     *
     * @return void
     */
    public function addProcessor(ProcessorInterface $processor)
    {
        $this->processors[] = $processor;
    }

    /**
     * Returns the registered processors.
     *
     * @return \Stackable The registered processors
     */
    protected function getProcessors()
    {
        return $this->processors;
    }

    /**
     * Returns the channel name, passed to the constructor.
     *
     * @return string The channel name
     */
    protected function getChannelName()
    {
        return $this->channelName;
    }

    /**
     * Adds a log record at the DEBUG level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addDebug($message, array $context = array())
    {
        return $this->debug($message, $context);
    }

    /**
     * Adds a log record at the INFO level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addInfo($message, array $context = array())
    {
        return $this->info($message, $context);
    }

    /**
     * Adds a log record at the NOTICE level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addNotice($message, array $context = array())
    {
        return $this->notice($message, $context);
    }

    /**
     * Adds a log record at the WARNING level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addWarning($message, array $context = array())
    {
        return $this->warning($message, $context);
    }

    /**
     * Adds a log record at the ERROR level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addError($message, array $context = array())
    {
        return $this->error($message, $context);
    }

    /**
     * Adds a log record at the CRITICAL level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addCritical($message, array $context = array())
    {
        return $this->critical($message, $context);
    }

    /**
     * Adds a log record at the ALERT level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addAlert($message, array $context = array())
    {
        return $this->alert($message, $context);
    }

    /**
     * Adds a log record at the EMERGENCY level.
     *
     * @param  string $message The log message
     * @param  array  $context The log context
     *
     * @return boolean Whether the record has been processed
     */
    public function addEmergency($message, array $context = array())
    {
        return $this->emergency($message, $context);
    }

    /**
     * System is unusable.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function emergency($message, array $context = array())
    {
        $this->log(LogLevel::EMERGENCY, $message, $context);
    }

    /**
     * Action must be taken immediately.
     *
     * Example: Entire website down, database unavailable, etc. This should
     * trigger the SMS alerts and wake you up.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function alert($message, array $context = array())
    {
        $this->log(LogLevel::ALERT, $message, $context);
    }

    /**
     * Critical conditions.
     *
     * Example: Application component unavailable, unexpected exception.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function critical($message, array $context = array())
    {
        $this->log(LogLevel::CRITICAL, $message, $context);
    }

    /**
     * Runtime errors that do not require immediate action but should typically
     * be logged and monitored.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function error($message, array $context = array())
    {
        $this->log(LogLevel::ERROR, $message, $context);
    }

    /**
     * Exceptional occurrences that are not errors.
     *
     * Example: Use of deprecated APIs, poor use of an API, undesirable things
     * that are not necessarily wrong.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function warning($message, array $context = array())
    {
        $this->log(LogLevel::WARNING, $message, $context);
    }

    /**
     * Normal but significant events.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return null
     */
    public function notice($message, array $context = array())
    {
        $this->log(LogLevel::NOTICE, $message, $context);
    }

    /**
     * Interesting events.
     *
     * Example: User logs in, SQL logs.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function info($message, array $context = array())
    {
        $this->log(LogLevel::INFO, $message, $context);
    }

    /**
     * Detailed debug information.
     *
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function debug($message, array $context = array())
    {
        $this->log(LogLevel::DEBUG, $message, $context);
    }

    /**
     * Logs with an arbitrary level.
     *
     * @param mixed  $level   The log level
     * @param string $message The message to log
     * @param array  $context The context for log
     *
     * @return void
     */
    public function log($level, $message, array $context = array())
    {
        $this->process(new LogMessage(mt_rand(), $level, $message, $context));
    }

    /**
     * Targe for the delegate method of the log message that processes
     * the log message asynchronously.
     *
     * @param \AppserverIo\Logger\LogMessageInterface $logMessage The message to be processed
     *
     * @return void
     */
    public function process(LogMessageInterface $logMessage)
    {

        // let the processors process the message
        foreach ($this->getProcessors() as $processor) {
            $processor->process($logMessage);
        }

        // let the handler log the message
        foreach ($this->getHandlers() as $handler) {
            $handler->handle($logMessage);
        }
    }

    /**
     * Appends the passed thread context.
     *
     * @param string $threadContext The thread context to append
     *
     * @return void
     * @see \AppserverIo\Logger\ThreadSafeLoggerInterface::appendThreadContext()
     */
    public function appendThreadContext($threadContext)
    {
        Logger::$threadContext = sprintf('%s-%s', Logger::$threadContext, $threadContext);
    }
}


1		<?php
2
3		/**
4		* AppserverIo\Logger\Logger
5		*
6		* NOTICE OF LICENSE
7		*
8		* This source file is subject to the Open Software License (OSL 3.0)
9		* that is available through the world-wide-web at this URL:
10		* http://opensource.org/licenses/osl-3.0.php
11		*
12		* PHP version 5
13		*
14		* @author Tim Wagner <[email protected]>
15		* @copyright 2015 TechDivision GmbH <[email protected]>
16		* @license http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
17		* @link http://github.com/appserver-io/logger
18		* @link http://www.appserver.io
19		*/
20
21		namespace AppserverIo\Logger;
22
23		use Psr\Log\LogLevel;
24		use AppserverIo\Logger\Handlers\HandlerInterface;
25		use AppserverIo\Logger\Processors\ProcessorInterface;
26
27		/**
28		* Thread-Safe and PSR-3 compatible logger implementation.
29		*
30		* @author Tim Wagner <[email protected]>
31		* @copyright 2015 TechDivision GmbH <[email protected]>
32		* @license http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
33		* @link http://github.com/appserver-io/logger
34		* @link http://www.appserver.io
35		*/
36		class Logger implements ThreadSafeLoggerInterface
37		{
38
39		/**
40		* The thread context of the thread we're logging for.
41		*
42		* @var string
43		*/
44		public static $threadContext = 'global';
45
46		/**
47		* The channel name we log to.
48		*
49		* @var string
50		*/
51		protected $channelName;
52
53		/**
54		* Array with the handlers.
55		*
56		* @var array
57		*/
58		protected $handlers;
59
60		/**
61		* Array with the processors.
62		*
63		* @var array
64		*/
65		protected $processors;
66
67		/**
68		* Initializes the logger instance with the log level.
69		*
70		* @param string $channelName The channel name
71		* @param array $handlers The array with the handlers
72		* @param array $processors The array with the processors
73		*/
74	2	public function __construct($channelName, array $handlers = array(), array $processors = array())
75		{
76
77		// initialize the passe values
78	2	$this->channelName = $channelName;
79
80		// initialize the stackables
81	2	$this->handlers = array();
82	2	$this->processors = array();
83
84		// add the passed handlers
85	2	foreach ($handlers as $handler) {
86		$this->addHandler($handler);
87		}
88
89		// add the passed processors
90	2	foreach ($processors as $processor) {
91		$this->addProcessor($processor);
92		}
93	2	}
94
95		/**
96		* Adds the passed handler.
97		*
98		* @param \AppserverIo\Logger\Handlers\HandlerInterface $handler The handler to be added
99		*
100		* @return void
101		*/
102	2	public function addHandler(HandlerInterface $handler)
103		{
104	2	$this->handlers[] = $handler;
105	2	}
106
107		/**
108		* Returns the registered handlers.
109		*
110		* @return \Stackable The registered handlers
111		*/
112	2	protected function getHandlers()
113		{
114	2	return $this->handlers;
115		}
116
117		/**
118		* Adds the passed processor.
119		*
120		* @param \AppserverIo\Logger\Processors\ProcessorInterface $processor The processor to be added
121		*
122		* @return void
123		*/
124		public function addProcessor(ProcessorInterface $processor)
125		{
126		$this->processors[] = $processor;
127		}
128
129		/**
130		* Returns the registered processors.
131		*
132		* @return \Stackable The registered processors
133		*/
134	2	protected function getProcessors()
135		{
136	2	return $this->processors;
137		}
138
139		/**
140		* Returns the channel name, passed to the constructor.
141		*
142		* @return string The channel name
143		*/
144		protected function getChannelName()
145		{
146		return $this->channelName;
147		}
148
149		/**
150		* Adds a log record at the DEBUG level.
151		*
152		* @param string $message The log message
153		* @param array $context The log context
154		*
155		* @return boolean Whether the record has been processed
156		*/
157		public function addDebug($message, array $context = array())
158		{
159		return $this->debug($message, $context);
160		}
161
162		/**
163		* Adds a log record at the INFO level.
164		*
165		* @param string $message The log message
166		* @param array $context The log context
167		*
168		* @return boolean Whether the record has been processed
169		*/
170		public function addInfo($message, array $context = array())
171		{
172		return $this->info($message, $context);
173		}
174
175		/**
176		* Adds a log record at the NOTICE level.
177		*
178		* @param string $message The log message
179		* @param array $context The log context
180		*
181		* @return boolean Whether the record has been processed
182		*/
183		public function addNotice($message, array $context = array())
184		{
185		return $this->notice($message, $context);
186		}
187
188		/**
189		* Adds a log record at the WARNING level.
190		*
191		* @param string $message The log message
192		* @param array $context The log context
193		*
194		* @return boolean Whether the record has been processed
195		*/
196		public function addWarning($message, array $context = array())
197		{
198		return $this->warning($message, $context);
199		}
200
201		/**
202		* Adds a log record at the ERROR level.
203		*
204		* @param string $message The log message
205		* @param array $context The log context
206		*
207		* @return boolean Whether the record has been processed
208		*/
209		public function addError($message, array $context = array())
210		{
211		return $this->error($message, $context);
212		}
213
214		/**
215		* Adds a log record at the CRITICAL level.
216		*
217		* @param string $message The log message
218		* @param array $context The log context
219		*
220		* @return boolean Whether the record has been processed
221		*/
222		public function addCritical($message, array $context = array())
223		{
224		return $this->critical($message, $context);
225		}
226
227		/**
228		* Adds a log record at the ALERT level.
229		*
230		* @param string $message The log message
231		* @param array $context The log context
232		*
233		* @return boolean Whether the record has been processed
234		*/
235		public function addAlert($message, array $context = array())
236		{
237		return $this->alert($message, $context);
238		}
239
240		/**
241		* Adds a log record at the EMERGENCY level.
242		*
243		* @param string $message The log message
244		* @param array $context The log context
245		*
246		* @return boolean Whether the record has been processed
247		*/
248		public function addEmergency($message, array $context = array())
249		{
250		return $this->emergency($message, $context);
251		}
252
253		/**
254		* System is unusable.
255		*
256		* @param string $message The message to log
257		* @param array $context The context for log
258		*
259		* @return void
260		*/
261		public function emergency($message, array $context = array())
262		{
263		$this->log(LogLevel::EMERGENCY, $message, $context);
264		}
265
266		/**
267		* Action must be taken immediately.
268		*
269		* Example: Entire website down, database unavailable, etc. This should
270		* trigger the SMS alerts and wake you up.
271		*
272		* @param string $message The message to log
273		* @param array $context The context for log
274		*
275		* @return void
276		*/
277		public function alert($message, array $context = array())
278		{
279		$this->log(LogLevel::ALERT, $message, $context);
280		}
281
282		/**
283		* Critical conditions.
284		*
285		* Example: Application component unavailable, unexpected exception.
286		*
287		* @param string $message The message to log
288		* @param array $context The context for log
289		*
290		* @return void
291		*/
292		public function critical($message, array $context = array())
293		{
294		$this->log(LogLevel::CRITICAL, $message, $context);
295		}
296
297		/**
298		* Runtime errors that do not require immediate action but should typically
299		* be logged and monitored.
300		*
301		* @param string $message The message to log
302		* @param array $context The context for log
303		*
304		* @return void
305		*/
306		public function error($message, array $context = array())
307		{
308		$this->log(LogLevel::ERROR, $message, $context);
309		}
310
311		/**
312		* Exceptional occurrences that are not errors.
313		*
314		* Example: Use of deprecated APIs, poor use of an API, undesirable things
315		* that are not necessarily wrong.
316		*
317		* @param string $message The message to log
318		* @param array $context The context for log
319		*
320		* @return void
321		*/
322		public function warning($message, array $context = array())
323		{
324		$this->log(LogLevel::WARNING, $message, $context);
325		}
326
327		/**
328		* Normal but significant events.
329		*
330		* @param string $message The message to log
331		* @param array $context The context for log
332		*
333		* @return null
334		*/
335		public function notice($message, array $context = array())
336		{
337		$this->log(LogLevel::NOTICE, $message, $context);
338		}
339
340		/**
341		* Interesting events.
342		*
343		* Example: User logs in, SQL logs.
344		*
345		* @param string $message The message to log
346		* @param array $context The context for log
347		*
348		* @return void
349		*/
350	1	public function info($message, array $context = array())
351		{
352	1	$this->log(LogLevel::INFO, $message, $context);
353	1	}
354
355		/**
356		* Detailed debug information.
357		*
358		* @param string $message The message to log
359		* @param array $context The context for log
360		*
361		* @return void
362		*/
363		public function debug($message, array $context = array())
364		{
365		$this->log(LogLevel::DEBUG, $message, $context);
366		}
367
368		/**
369		* Logs with an arbitrary level.
370		*
371		* @param mixed $level The log level
372		* @param string $message The message to log
373		* @param array $context The context for log
374		*
375		* @return void
376		*/
377	2	public function log($level, $message, array $context = array())
378		{
379	2	$this->process(new LogMessage(mt_rand(), $level, $message, $context));
380	2	}
381
382		/**
383		* Targe for the delegate method of the log message that processes
384		* the log message asynchronously.
385		*
386		* @param \AppserverIo\Logger\LogMessageInterface $logMessage The message to be processed
387		*
388		* @return void
389		*/
390	2	public function process(LogMessageInterface $logMessage)
391		{
392
393		// let the processors process the message
394	2	foreach ($this->getProcessors() as $processor) {
395		$processor->process($logMessage);
396		}
397
398		// let the handler log the message
399	2	foreach ($this->getHandlers() as $handler) {
400	2	$handler->handle($logMessage);
401		}
402	2	}
403
404		/**
405		* Appends the passed thread context.
406		*
407		* @param string $threadContext The thread context to append
408		*
409		* @return void
410		* @see \AppserverIo\Logger\ThreadSafeLoggerInterface::appendThreadContext()
411		*/
412		public function appendThreadContext($threadContext)
413		{
414		Logger::$threadContext = sprintf('%s-%s', Logger::$threadContext, $threadContext);
415		}
416		}
417

appserver-io / logger

Logger::error() A last analyzed 2018-06-19 19:24 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

Logger::error() A
last analyzed 2018-06-19 19:24 UTC