. * */ namespace Friendica\Test\src\Core; use Dice\Dice; use Friendica\Core\Config\IConfig; use Friendica\Core\Config\PreloadConfig; use Friendica\Core\Hook; use Friendica\Core\L10n; use Friendica\Core\Session\ISession; use Friendica\Core\StorageManager; use Friendica\Database\Database; use Friendica\DI; use Friendica\Factory\ConfigFactory; use Friendica\Model\Config\Config; use Friendica\Model\Storage; use Friendica\Core\Session; use Friendica\Model\Storage\StorageException; use Friendica\Test\DatabaseTest; use Friendica\Test\Util\Database\StaticDatabase; use Friendica\Test\Util\VFSTrait; use Friendica\Util\ConfigFileLoader; use Friendica\Util\Profiler; use Psr\Log\LoggerInterface; use Psr\Log\NullLogger; use Friendica\Test\Util\SampleStorageBackend; class StorageManagerTest extends DatabaseTest { /** @var Database */ private $dba; /** @var IConfig */ private $config; /** @var LoggerInterface */ private $logger; /** @var L10n */ private $l10n; use VFSTrait; protected function setUp(): void { parent::setUp(); $this->setUpVfsDir(); $this->logger = new NullLogger(); $profiler = \Mockery::mock(Profiler::class); $profiler->shouldReceive('saveTimestamp')->withAnyArgs()->andReturn(true); // load real config to avoid mocking every config-entry which is related to the Database class $configFactory = new ConfigFactory(); $loader = new ConfigFileLoader($this->root->url()); $configCache = $configFactory->createCache($loader); $this->dba = new StaticDatabase($configCache, $profiler, $this->logger); $configModel = new Config($this->dba); $this->config = new PreloadConfig($configCache, $configModel); $this->l10n = \Mockery::mock(L10n::class); } /** * Test plain instancing first */ public function testInstance() { $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); self::assertInstanceOf(StorageManager::class, $storageManager); } public function dataStorages() { return [ 'empty' => [ 'name' => '', 'assert' => null, 'assertName' => '', 'userBackend' => false, ], 'database' => [ 'name' => Storage\Database::NAME, 'assert' => Storage\Database::class, 'assertName' => Storage\Database::NAME, 'userBackend' => true, ], 'filesystem' => [ 'name' => Storage\Filesystem::NAME, 'assert' => Storage\Filesystem::class, 'assertName' => Storage\Filesystem::NAME, 'userBackend' => true, ], 'systemresource' => [ 'name' => Storage\SystemResource::NAME, 'assert' => Storage\SystemResource::class, 'assertName' => Storage\SystemResource::NAME, // false here, because SystemResource isn't meant to be a user backend, // it's for system resources only 'userBackend' => false, ], 'invalid' => [ 'name' => 'invalid', 'assert' => null, 'assertName' => '', 'userBackend' => false, ], ]; } /** * Data array for legacy backends * * @todo 2020.09 After 2 releases, remove the legacy functionality and these data array with it * * @return array */ public function dataLegacyBackends() { return [ 'legacyDatabase' => [ 'name' => 'Friendica\Model\Storage\Database', 'assert' => Storage\Database::class, 'assertName' => Storage\Database::NAME, 'userBackend' => true, ], 'legacyFilesystem' => [ 'name' => 'Friendica\Model\Storage\Filesystem', 'assert' => Storage\Filesystem::class, 'assertName' => Storage\Filesystem::NAME, 'userBackend' => true, ], 'legacySystemResource' => [ 'name' => 'Friendica\Model\Storage\SystemResource', 'assert' => Storage\SystemResource::class, 'assertName' => Storage\SystemResource::NAME, 'userBackend' => false, ], ]; } /** * Test the getByName() method * * @dataProvider dataStorages * @dataProvider dataLegacyBackends */ public function testGetByName($name, $assert, $assertName, $userBackend) { $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); $storage = $storageManager->getByName($name, $userBackend); if (!empty($assert)) { self::assertInstanceOf(Storage\IStorage::class, $storage); self::assertInstanceOf($assert, $storage); } else { self::assertNull($storage); } self::assertEquals($assertName, $storage); } /** * Test the isValidBackend() method * * @dataProvider dataStorages */ public function testIsValidBackend($name, $assert, $assertName, $userBackend) { $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); // true in every of the backends self::assertEquals(!empty($assertName), $storageManager->isValidBackend($name)); // if userBackend is set to true, filter out e.g. SystemRessource self::assertEquals($userBackend, $storageManager->isValidBackend($name, true)); } /** * Test the method listBackends() with default setting */ public function testListBackends() { $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); self::assertEquals(StorageManager::DEFAULT_BACKENDS, $storageManager->listBackends()); } /** * Test the method getBackend() * * @dataProvider dataStorages */ public function testGetBackend($name, $assert, $assertName, $userBackend) { $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); self::assertNull($storageManager->getBackend()); if ($userBackend) { $storageManager->setBackend($name); self::assertInstanceOf($assert, $storageManager->getBackend()); } } /** * Test the method getBackend() with a pre-configured backend * * @dataProvider dataStorages * @dataProvider dataLegacyBackends */ public function testPresetBackend($name, $assert, $assertName, $userBackend) { $this->config->set('storage', 'name', $name); $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); if ($userBackend) { self::assertInstanceOf($assert, $storageManager->getBackend()); } else { self::assertNull($storageManager->getBackend()); } } /** * Tests the register and unregister methods for a new backend storage class * * Uses a sample storage for testing * * @see SampleStorageBackend */ public function testRegisterUnregisterBackends() { /// @todo Remove dice once "Hook" is dynamic and mockable $dice = (new Dice()) ->addRules(include __DIR__ . '/../../../static/dependencies.config.php') ->addRule(Database::class, ['instanceOf' => StaticDatabase::class, 'shared' => true]) ->addRule(ISession::class, ['instanceOf' => Session\Memory::class, 'shared' => true, 'call' => null]); DI::init($dice); $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); self::assertTrue($storageManager->register(SampleStorageBackend::class)); self::assertEquals(array_merge(StorageManager::DEFAULT_BACKENDS, [ SampleStorageBackend::getName() => SampleStorageBackend::class, ]), $storageManager->listBackends()); self::assertEquals(array_merge(StorageManager::DEFAULT_BACKENDS, [ SampleStorageBackend::getName() => SampleStorageBackend::class, ]), $this->config->get('storage', 'backends')); // inline call to register own class as hook (testing purpose only) SampleStorageBackend::registerHook(); Hook::loadHooks(); self::assertTrue($storageManager->setBackend(SampleStorageBackend::NAME)); self::assertEquals(SampleStorageBackend::NAME, $this->config->get('storage', 'name')); self::assertInstanceOf(SampleStorageBackend::class, $storageManager->getBackend()); self::assertTrue($storageManager->unregister(SampleStorageBackend::class)); self::assertEquals(StorageManager::DEFAULT_BACKENDS, $this->config->get('storage', 'backends')); self::assertEquals(StorageManager::DEFAULT_BACKENDS, $storageManager->listBackends()); self::assertNull($storageManager->getBackend()); self::assertNull($this->config->get('storage', 'name')); } /** * Test moving data to a new storage (currently testing db & filesystem) * * @dataProvider dataStorages */ public function testMoveStorage($name, $assert, $assertName, $userBackend) { if (!$userBackend) { self::markTestSkipped("No user backend"); } $this->loadFixture(__DIR__ . '/../../datasets/storage/database.fixture.php', $this->dba); $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); $storage = $storageManager->getByName($name); $storageManager->move($storage); $photos = $this->dba->select('photo', ['backend-ref', 'backend-class', 'id', 'data']); while ($photo = $this->dba->fetch($photos)) { self::assertEmpty($photo['data']); $storage = $storageManager->getByName($photo['backend-class']); $data = $storage->get($photo['backend-ref']); self::assertNotEmpty($data); } } /** * Test moving data to a WRONG storage */ public function testMoveStorageWrong() { $this->expectExceptionMessage("Can't move to storage backend 'SystemResource'"); $this->expectException(StorageException::class); $storageManager = new StorageManager($this->dba, $this->config, $this->logger, $this->l10n); $storage = $storageManager->getByName(Storage\SystemResource::getName()); $storageManager->move($storage); } }