Implement Hook::callAll('storage_instance') call for addons and add a description for it.

- Remove implicit Dice usage
- Add concrete instance creating
- Adding Hook call for addon instance creating
- Updating doc for Hook
- Updating tests

tests/Util/SampleStorageBackend.php

@@ -2,9 +2,12 @@
 
 namespace Friendica\Test\Util;
 
+use Friendica\App;
+use Friendica\Core\Hook;
 use Friendica\Model\Storage\IStorage;
 
 use Friendica\Core\L10n\L10n;
+use Mockery\MockInterface;
 
 /**
  * A backend storage example class
@@ -91,4 +94,13 @@ class SampleStorageBackend implements IStorage
 	{
 		return self::NAME;
 	}
+
+	/**
+	 * This one is a hack to register this class to the hook
+	 */
+	public static function registerHook()
+	{
+		Hook::register('storage_instance', __DIR__ . '/SampleStorageBackendInstance.php', 'create_instance');
+	}
 }
+

tests/Util/SampleStorageBackendInstance.php

@@ -0,0 +1,18 @@
+<?php
+
+// contains a test-hook call for creating a storage instance
+
+use Friendica\App;
+use Friendica\Core\L10n\L10n;
+use Friendica\Test\Util\SampleStorageBackend;
+use Mockery\MockInterface;
+
+function create_instance(App $a, &$data)
+{
+	/** @var L10n|MockInterface $l10n */
+	$l10n = \Mockery::mock(L10n::class);
+
+	if ($data['name'] == SampleStorageBackend::getName()) {
+		$data['storage'] = new SampleStorageBackend($l10n);
+	}
+}