Merge remote-tracking branch 'odino/master'

README.mdown

@@ -134,6 +134,7 @@ Handlers
 - _RavenHandler_: Logs records to a [Sentry](http://getsentry.com/) server using
   [raven](https://packagist.org/packages/raven/raven).
 - _ZendMonitorHandler_: Logs records to the Zend Monitor present in Zend Server.
+- _NewRelicHandler_: Logs records to a [NewRelic](http://newrelic.com/) application.
 
 ### Logging in development
 

src/Monolog/Handler/NewRelicHandler.php

@@ -0,0 +1,53 @@
+<?php
+
+/*
+ * This file is part of the Monolog package.
+ *
+ * (c) Jordi Boggiano <j.boggiano@seld.be>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Monolog\Handler;
+
+use Monolog\Handler\MissingExtensionException;
+
+/**
+ * Class to record a log on a NewRelic application
+ *
+ * @see https://newrelic.com/docs/php/new-relic-for-php
+ */
+class NewRelicHandler extends AbstractProcessingHandler
+{    
+    const ERROR_MISSING_EXTENSION = "The NewRelic PHP extension is not installed on this system, therefore you can't use the NewRelicHandler";
+    const NEWRELIC_EXTENSION_NAME = 'newrelic';
+    
+    /**
+     * {@inheritdoc}
+     */
+    protected function write(array $record)
+    {
+        if ($this->isNewRelicEnabled()) {
+            newrelic_notice_error($record['message']);
+
+            foreach ($record['context'] as $key => $parameter) {
+                newrelic_add_custom_parameter($key, $parameter);
+            }
+            
+            return;
+        }
+        
+        throw new MissingExtensionException(self::ERROR_MISSING_EXTENSION);
+    }
+    
+    /**
+     * Checks whether the NewRelic extension is enabled in the system.
+     * 
+     * @return bool
+     */
+    protected function isNewRelicEnabled()
+    {
+        return (bool) extension_loaded(self::NEWRELIC_EXTENSION_NAME);
+    }
+}

tests/Monolog/Handler/NewRelicHandlerTest.php

@@ -0,0 +1,63 @@
+<?php
+
+/*
+ * This file is part of the Monolog package.
+ *
+ * (c) Jordi Boggiano <j.boggiano@seld.be>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Monolog\Handler;
+
+use Monolog\TestCase;
+use Monolog\Logger;
+
+class NewRelicHandlerTest extends TestCase
+{    
+    /**
+     * @expectedException Monolog\Handler\MissingExtensionException
+     */
+    public function testThehandlerThrowsAnExceptionIfTheNRExtensionIsNotLoaded()
+    {
+        $handler = new StubNewRelicHandlerWithoutExtension();
+        $handler->handle($this->getRecord());
+    }
+    
+    public function testThehandlerCanHandleTheRecord()
+    {
+        $handler = new StubNewRelicHandler();
+        $handler->handle($this->getRecord());
+    }
+    
+    public function testThehandlerCanAddParamsToTheNewRelicTrace()
+    {
+        $handler = new StubNewRelicHandler();
+        $handler->handle($this->getRecord(100, 'log message', array('a' => 'b')));
+    }
+}
+
+class StubNewRelicHandlerWithoutExtension extends NewRelicHandler
+{
+    protected function isNewRelicEnabled()
+    {
+        return false;
+    }
+}
+
+class StubNewRelicHandler extends NewRelicHandler
+{
+    protected function isNewRelicEnabled()
+    {
+        return true;
+    }
+}
+
+function newrelic_notice_error() {
+    return true;
+}
+
+function newrelic_add_custom_parameter() {
+    return true;
+}