Add support for custom savers (#63)

Co-authored-by: Elan Ruusamäe <glen@pld-linux.org>

Author: dmitryuk

README.md

@@ -124,6 +124,7 @@ To deliver captured data to XHGui, you will need one of the savers to submit to
 - [File saver](#file-saver)
 - [MongoDB Saver](#mongodb-saver) (deprecated)
 - [PDO Saver](#pdo-saver) (deprecated)
+- [Custom Saver](#custom-saver) Custom saver
 
 ### Stack saver
 
@@ -252,6 +253,31 @@ Example config:
     ),
 ```
 
+## Custom Saver
+You can create your own profile saver by implementing `SaverInterface` and calling `setSaver()`.
+
+```php
+use Xhgui\Profiler\Profiler;
+use Xhgui\Profiler\Saver\SaverInterface;
+
+class StdOutSaver implements SaverInterface
+{
+    public function isSupported()
+    {
+        return true;
+    }
+    
+    public function save(array $data)
+    {
+        fwrite(STDOUT, json_encode($data));
+    }
+}
+
+//...
+/** @var Profiler $profiler */
+$profiler->setSaver(new StdOutSaver());
+```
+
 ## Configure Profiling Rate
 
 You may want to change how frequently you profile the application.  The

src/Profiler.php

@@ -177,6 +177,16 @@ public function isRunning()
         return $this->running;
     }
 
+    /**
+     * Set profiler saver
+     *
+     * @param  SaverInterface  $saver
+     */
+    public function setSaver(SaverInterface $saver)
+    {
+        $this->saveHandler = $saver;
+    }
+
     /**
      * Returns value of `profiler.enable` function evaluation
      *

tests/Resources/NullSaver.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Xhgui\Profiler\Test\Resources;
+
+use Exception;
+use Xhgui\Profiler\Saver\SaverInterface;
+
+class NullSaver implements SaverInterface
+{
+    public function isSupported()
+    {
+        return true;
+    }
+
+    public function save(array $data)
+    {
+        throw new Exception('NullSaver executed');
+    }
+}

tests/Saver/NullSaverTest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Xhgui\Profiler\Test\Saver;
+
+use Exception;
+use Xhgui\Profiler\Profiler;
+use Xhgui\Profiler\Test\Resources\NullSaver;
+use Xhgui\Profiler\Test\TestCase;
+
+class NullSaverTest extends TestCase
+{
+    public function setCustomSaver()
+    {
+        $saver = new NullSaver();
+        $profiler = new Profiler(array());
+        $profiler->setSaver($saver);
+        $profiler->start();
+        try {
+            $profiler->stop();
+            $this->markTestIncomplete('Custom saver not executed');
+        } catch (Exception $e) {
+            $this->assertEquals('CustomSaver executed', $e->getMessage());
+        }
+    }
+}