Split Storage usage and Storage configuration
This commit is contained in:
parent
ac9e5df614
commit
065b46c721
|
@ -119,6 +119,43 @@ class StorageManager
|
||||||
return $storage;
|
return $storage;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return storage backend configuration by registered name
|
||||||
|
*
|
||||||
|
* @param string $name Backend name
|
||||||
|
*
|
||||||
|
* @return Storage\IStorageConfiguration|false
|
||||||
|
*
|
||||||
|
* @throws Storage\InvalidClassStorageException in case there's no backend class for the name
|
||||||
|
* @throws Storage\StorageException in case of an unexpected failure during the hook call
|
||||||
|
*/
|
||||||
|
public function getConfigurationByName(string $name)
|
||||||
|
{
|
||||||
|
switch ($name) {
|
||||||
|
// Try the filesystem backend
|
||||||
|
case Storage\Filesystem::getName():
|
||||||
|
return new Storage\FilesystemConfig($this->config, $this->l10n);
|
||||||
|
// try the database backend
|
||||||
|
case Storage\Database::getName():
|
||||||
|
return false;
|
||||||
|
default:
|
||||||
|
$data = [
|
||||||
|
'name' => $name,
|
||||||
|
'storage_config' => null,
|
||||||
|
];
|
||||||
|
try {
|
||||||
|
Hook::callAll('storage_config', $data);
|
||||||
|
if (!($data['storage_config'] ?? null) instanceof Storage\IStorageConfiguration) {
|
||||||
|
throw new Storage\InvalidClassStorageException(sprintf('Configuration for backend %s was not found', $name));
|
||||||
|
}
|
||||||
|
|
||||||
|
return $data['storage_config'];
|
||||||
|
} catch (InternalServerErrorException $exception) {
|
||||||
|
throw new Storage\StorageException(sprintf('Failed calling hook::storage_config for backend %s', $name), $exception);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Return storage backend class by registered name
|
* Return storage backend class by registered name
|
||||||
*
|
*
|
||||||
|
@ -142,7 +179,8 @@ class StorageManager
|
||||||
switch ($name) {
|
switch ($name) {
|
||||||
// Try the filesystem backend
|
// Try the filesystem backend
|
||||||
case Storage\Filesystem::getName():
|
case Storage\Filesystem::getName():
|
||||||
$this->backendInstances[$name] = new Storage\Filesystem($this->config, $this->l10n);
|
$storageConfig = new Storage\FilesystemConfig($this->config, $this->l10n);
|
||||||
|
$this->backendInstances[$name] = new Storage\Filesystem($storageConfig->getStoragePath());
|
||||||
break;
|
break;
|
||||||
// try the database backend
|
// try the database backend
|
||||||
case Storage\Database::getName():
|
case Storage\Database::getName():
|
||||||
|
|
|
@ -113,22 +113,6 @@ class Database implements IWritableStorage
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* @inheritDoc
|
|
||||||
*/
|
|
||||||
public function getOptions(): array
|
|
||||||
{
|
|
||||||
return [];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @inheritDoc
|
|
||||||
*/
|
|
||||||
public function saveOptions(array $data): array
|
|
||||||
{
|
|
||||||
return [];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @inheritDoc
|
* @inheritDoc
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -22,8 +22,6 @@
|
||||||
namespace Friendica\Model\Storage;
|
namespace Friendica\Model\Storage;
|
||||||
|
|
||||||
use Exception;
|
use Exception;
|
||||||
use Friendica\Core\Config\IConfig;
|
|
||||||
use Friendica\Core\L10n;
|
|
||||||
use Friendica\Util\Strings;
|
use Friendica\Util\Strings;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -40,30 +38,17 @@ class Filesystem implements IWritableStorage
|
||||||
{
|
{
|
||||||
const NAME = 'Filesystem';
|
const NAME = 'Filesystem';
|
||||||
|
|
||||||
// Default base folder
|
|
||||||
const DEFAULT_BASE_FOLDER = 'storage';
|
|
||||||
|
|
||||||
/** @var IConfig */
|
|
||||||
private $config;
|
|
||||||
|
|
||||||
/** @var string */
|
/** @var string */
|
||||||
private $basePath;
|
private $basePath;
|
||||||
|
|
||||||
/** @var L10n */
|
|
||||||
private $l10n;
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Filesystem constructor.
|
* Filesystem constructor.
|
||||||
*
|
*
|
||||||
* @param IConfig $config
|
* @param string $filesystemPath
|
||||||
* @param L10n $l10n
|
|
||||||
*/
|
*/
|
||||||
public function __construct(IConfig $config, L10n $l10n)
|
public function __construct(string $filesystemPath = FilesystemConfig::DEFAULT_BASE_FOLDER)
|
||||||
{
|
{
|
||||||
$this->config = $config;
|
$path = $filesystemPath;
|
||||||
$this->l10n = $l10n;
|
|
||||||
|
|
||||||
$path = $this->config->get('storage', 'filesystem_path', self::DEFAULT_BASE_FOLDER);
|
|
||||||
$this->basePath = rtrim($path, '/');
|
$this->basePath = rtrim($path, '/');
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -176,37 +161,6 @@ class Filesystem implements IWritableStorage
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* @inheritDoc
|
|
||||||
*/
|
|
||||||
public function getOptions(): array
|
|
||||||
{
|
|
||||||
return [
|
|
||||||
'storagepath' => [
|
|
||||||
'input',
|
|
||||||
$this->l10n->t('Storage base path'),
|
|
||||||
$this->basePath,
|
|
||||||
$this->l10n->t('Folder where uploaded files are saved. For maximum security, This should be a path outside web server folder tree')
|
|
||||||
]
|
|
||||||
];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @inheritDoc
|
|
||||||
*/
|
|
||||||
public function saveOptions(array $data): array
|
|
||||||
{
|
|
||||||
$storagePath = $data['storagepath'] ?? '';
|
|
||||||
if ($storagePath === '' || !is_dir($storagePath)) {
|
|
||||||
return [
|
|
||||||
'storagepath' => $this->l10n->t('Enter a valid existing folder')
|
|
||||||
];
|
|
||||||
};
|
|
||||||
$this->config->set('storage', 'filesystem_path', $storagePath);
|
|
||||||
$this->basePath = $storagePath;
|
|
||||||
return [];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @inheritDoc
|
* @inheritDoc
|
||||||
*/
|
*/
|
||||||
|
|
99
src/Model/Storage/FilesystemConfig.php
Normal file
99
src/Model/Storage/FilesystemConfig.php
Normal file
|
@ -0,0 +1,99 @@
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* @copyright Copyright (C) 2010-2021, the Friendica project
|
||||||
|
*
|
||||||
|
* @license GNU AGPL version 3 or any later version
|
||||||
|
*
|
||||||
|
* This program is free software: you can redistribute it and/or modify
|
||||||
|
* it under the terms of the GNU Affero General Public License as
|
||||||
|
* published by the Free Software Foundation, either version 3 of the
|
||||||
|
* License, or (at your option) any later version.
|
||||||
|
*
|
||||||
|
* This program is distributed in the hope that it will be useful,
|
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
* GNU Affero General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU Affero General Public License
|
||||||
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace Friendica\Model\Storage;
|
||||||
|
|
||||||
|
use Friendica\Core\Config\IConfig;
|
||||||
|
use Friendica\Core\L10n;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Filesystem based storage backend configuration
|
||||||
|
*/
|
||||||
|
class FilesystemConfig implements IStorageConfiguration
|
||||||
|
{
|
||||||
|
// Default base folder
|
||||||
|
const DEFAULT_BASE_FOLDER = 'storage';
|
||||||
|
|
||||||
|
/** @var IConfig */
|
||||||
|
private $config;
|
||||||
|
|
||||||
|
/** @var string */
|
||||||
|
private $storagePath;
|
||||||
|
|
||||||
|
/** @var L10n */
|
||||||
|
private $l10n;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns the current storage path
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getStoragePath(): string
|
||||||
|
{
|
||||||
|
return $this->storagePath;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Filesystem constructor.
|
||||||
|
*
|
||||||
|
* @param IConfig $config
|
||||||
|
* @param L10n $l10n
|
||||||
|
*/
|
||||||
|
public function __construct(IConfig $config, L10n $l10n)
|
||||||
|
{
|
||||||
|
$this->config = $config;
|
||||||
|
$this->l10n = $l10n;
|
||||||
|
|
||||||
|
$path = $this->config->get('storage', 'filesystem_path', self::DEFAULT_BASE_FOLDER);
|
||||||
|
$this->storagePath = rtrim($path, '/');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @inheritDoc
|
||||||
|
*/
|
||||||
|
public function getOptions(): array
|
||||||
|
{
|
||||||
|
return [
|
||||||
|
'storagepath' => [
|
||||||
|
'input',
|
||||||
|
$this->l10n->t('Storage base path'),
|
||||||
|
$this->storagePath,
|
||||||
|
$this->l10n->t('Folder where uploaded files are saved. For maximum security, This should be a path outside web server folder tree')
|
||||||
|
]
|
||||||
|
];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @inheritDoc
|
||||||
|
*/
|
||||||
|
public function saveOptions(array $data): array
|
||||||
|
{
|
||||||
|
$storagePath = $data['storagepath'] ?? '';
|
||||||
|
if ($storagePath === '' || !is_dir($storagePath)) {
|
||||||
|
return [
|
||||||
|
'storagepath' => $this->l10n->t('Enter a valid existing folder')
|
||||||
|
];
|
||||||
|
};
|
||||||
|
$this->config->set('storage', 'filesystem_path', $storagePath);
|
||||||
|
$this->storagePath = $storagePath;
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
78
src/Model/Storage/IStorageConfiguration.php
Normal file
78
src/Model/Storage/IStorageConfiguration.php
Normal file
|
@ -0,0 +1,78 @@
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* @copyright Copyright (C) 2010-2021, the Friendica project
|
||||||
|
*
|
||||||
|
* @license GNU AGPL version 3 or any later version
|
||||||
|
*
|
||||||
|
* This program is free software: you can redistribute it and/or modify
|
||||||
|
* it under the terms of the GNU Affero General Public License as
|
||||||
|
* published by the Free Software Foundation, either version 3 of the
|
||||||
|
* License, or (at your option) any later version.
|
||||||
|
*
|
||||||
|
* This program is distributed in the hope that it will be useful,
|
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
* GNU Affero General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU Affero General Public License
|
||||||
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace Friendica\Model\Storage;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The interface to use for configurable storage backends
|
||||||
|
*/
|
||||||
|
interface IStorageConfiguration
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Get info about storage options
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
|
*
|
||||||
|
* This method return an array with information about storage options
|
||||||
|
* from which the form presented to the user is build.
|
||||||
|
*
|
||||||
|
* The returned array is:
|
||||||
|
*
|
||||||
|
* [
|
||||||
|
* 'option1name' => [ ..info.. ],
|
||||||
|
* 'option2name' => [ ..info.. ],
|
||||||
|
* ...
|
||||||
|
* ]
|
||||||
|
*
|
||||||
|
* An empty array can be returned if backend doesn't have any options
|
||||||
|
*
|
||||||
|
* The info array for each option MUST be as follows:
|
||||||
|
*
|
||||||
|
* [
|
||||||
|
* 'type', // define the field used in form, and the type of data.
|
||||||
|
* // one of 'checkbox', 'combobox', 'custom', 'datetime',
|
||||||
|
* // 'input', 'intcheckbox', 'password', 'radio', 'richtext'
|
||||||
|
* // 'select', 'select_raw', 'textarea'
|
||||||
|
*
|
||||||
|
* 'label', // Translatable label of the field
|
||||||
|
* 'value', // Current value
|
||||||
|
* 'help text', // Translatable description for the field
|
||||||
|
* extra data // Optional. Depends on 'type':
|
||||||
|
* // select: array [ value => label ] of choices
|
||||||
|
* // intcheckbox: value of input element
|
||||||
|
* // select_raw: prebuild html string of < option > tags
|
||||||
|
* ]
|
||||||
|
*
|
||||||
|
* See https://github.com/friendica/friendica/wiki/Quick-Template-Guide
|
||||||
|
*/
|
||||||
|
public function getOptions(): array;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Validate and save options
|
||||||
|
*
|
||||||
|
* @param array $data Array [optionname => value] to be saved
|
||||||
|
*
|
||||||
|
* @return array Validation errors: [optionname => error message]
|
||||||
|
*
|
||||||
|
* Return array must be empty if no error.
|
||||||
|
*/
|
||||||
|
public function saveOptions(array $data): array;
|
||||||
|
}
|
|
@ -50,54 +50,4 @@ interface IWritableStorage extends IStorage
|
||||||
* @throws ReferenceStorageException in case the reference doesn't exist
|
* @throws ReferenceStorageException in case the reference doesn't exist
|
||||||
*/
|
*/
|
||||||
public function delete(string $reference);
|
public function delete(string $reference);
|
||||||
|
|
||||||
/**
|
|
||||||
* Get info about storage options
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*
|
|
||||||
* This method return an array with informations about storage options
|
|
||||||
* from which the form presented to the user is build.
|
|
||||||
*
|
|
||||||
* The returned array is:
|
|
||||||
*
|
|
||||||
* [
|
|
||||||
* 'option1name' => [ ..info.. ],
|
|
||||||
* 'option2name' => [ ..info.. ],
|
|
||||||
* ...
|
|
||||||
* ]
|
|
||||||
*
|
|
||||||
* An empty array can be returned if backend doesn't have any options
|
|
||||||
*
|
|
||||||
* The info array for each option MUST be as follows:
|
|
||||||
*
|
|
||||||
* [
|
|
||||||
* 'type', // define the field used in form, and the type of data.
|
|
||||||
* // one of 'checkbox', 'combobox', 'custom', 'datetime',
|
|
||||||
* // 'input', 'intcheckbox', 'password', 'radio', 'richtext'
|
|
||||||
* // 'select', 'select_raw', 'textarea'
|
|
||||||
*
|
|
||||||
* 'label', // Translatable label of the field
|
|
||||||
* 'value', // Current value
|
|
||||||
* 'help text', // Translatable description for the field
|
|
||||||
* extra data // Optional. Depends on 'type':
|
|
||||||
* // select: array [ value => label ] of choices
|
|
||||||
* // intcheckbox: value of input element
|
|
||||||
* // select_raw: prebuild html string of < option > tags
|
|
||||||
* ]
|
|
||||||
*
|
|
||||||
* See https://github.com/friendica/friendica/wiki/Quick-Template-Guide
|
|
||||||
*/
|
|
||||||
public function getOptions(): array;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validate and save options
|
|
||||||
*
|
|
||||||
* @param array $data Array [optionname => value] to be saved
|
|
||||||
*
|
|
||||||
* @return array Validation errors: [optionname => error message]
|
|
||||||
*
|
|
||||||
* Return array must be empty if no error.
|
|
||||||
*/
|
|
||||||
public function saveOptions(array $data): array;
|
|
||||||
}
|
}
|
||||||
|
|
|
@ -24,6 +24,7 @@ namespace Friendica\Module\Admin;
|
||||||
use Friendica\Core\Renderer;
|
use Friendica\Core\Renderer;
|
||||||
use Friendica\DI;
|
use Friendica\DI;
|
||||||
use Friendica\Model\Storage\InvalidClassStorageException;
|
use Friendica\Model\Storage\InvalidClassStorageException;
|
||||||
|
use Friendica\Model\Storage\IStorageConfiguration;
|
||||||
use Friendica\Model\Storage\IWritableStorage;
|
use Friendica\Model\Storage\IWritableStorage;
|
||||||
use Friendica\Module\BaseAdmin;
|
use Friendica\Module\BaseAdmin;
|
||||||
use Friendica\Util\Strings;
|
use Friendica\Util\Strings;
|
||||||
|
@ -39,38 +40,40 @@ class Storage extends BaseAdmin
|
||||||
$storagebackend = Strings::escapeTags(trim($parameters['name'] ?? ''));
|
$storagebackend = Strings::escapeTags(trim($parameters['name'] ?? ''));
|
||||||
|
|
||||||
try {
|
try {
|
||||||
/** @var IWritableStorage $newstorage */
|
/** @var IStorageConfiguration|false $newStorageConfig */
|
||||||
$newstorage = DI::storageManager()->getWritableStorageByName($storagebackend);
|
$newStorageConfig = DI::storageManager()->getConfigurationByName($storagebackend);
|
||||||
} catch (InvalidClassStorageException $storageException) {
|
} catch (InvalidClassStorageException $storageException) {
|
||||||
notice(DI::l10n()->t('Storage backend, %s is invalid.', $storagebackend));
|
notice(DI::l10n()->t('Storage backend, %s is invalid.', $storagebackend));
|
||||||
DI::baseUrl()->redirect('admin/storage');
|
DI::baseUrl()->redirect('admin/storage');
|
||||||
}
|
}
|
||||||
|
|
||||||
// save storage backend form
|
if ($newStorageConfig !== false) {
|
||||||
$storage_opts = $newstorage->getOptions();
|
// save storage backend form
|
||||||
$storage_form_prefix = preg_replace('|[^a-zA-Z0-9]|', '', $storagebackend);
|
$storage_opts = $newStorageConfig->getOptions();
|
||||||
$storage_opts_data = [];
|
$storage_form_prefix = preg_replace('|[^a-zA-Z0-9]|', '', $storagebackend);
|
||||||
foreach ($storage_opts as $name => $info) {
|
$storage_opts_data = [];
|
||||||
$fieldname = $storage_form_prefix . '_' . $name;
|
foreach ($storage_opts as $name => $info) {
|
||||||
switch ($info[0]) { // type
|
$fieldname = $storage_form_prefix . '_' . $name;
|
||||||
case 'checkbox':
|
switch ($info[0]) { // type
|
||||||
case 'yesno':
|
case 'checkbox':
|
||||||
$value = !empty($_POST[$fieldname]);
|
case 'yesno':
|
||||||
break;
|
$value = !empty($_POST[$fieldname]);
|
||||||
default:
|
break;
|
||||||
$value = $_POST[$fieldname] ?? '';
|
default:
|
||||||
|
$value = $_POST[$fieldname] ?? '';
|
||||||
|
}
|
||||||
|
$storage_opts_data[$name] = $value;
|
||||||
}
|
}
|
||||||
$storage_opts_data[$name] = $value;
|
unset($name);
|
||||||
}
|
unset($info);
|
||||||
unset($name);
|
|
||||||
unset($info);
|
|
||||||
|
|
||||||
$storage_form_errors = $newstorage->saveOptions($storage_opts_data);
|
$storage_form_errors = $newStorageConfig->saveOptions($storage_opts_data);
|
||||||
if (count($storage_form_errors)) {
|
if (count($storage_form_errors)) {
|
||||||
foreach ($storage_form_errors as $name => $err) {
|
foreach ($storage_form_errors as $name => $err) {
|
||||||
notice(DI::l10n()->t('Storage backend %s error: %s', $storage_opts[$name][1], $err));
|
notice(DI::l10n()->t('Storage backend %s error: %s', $storage_opts[$name][1], $err));
|
||||||
|
}
|
||||||
|
DI::baseUrl()->redirect('admin/storage');
|
||||||
}
|
}
|
||||||
DI::baseUrl()->redirect('admin/storage');
|
|
||||||
}
|
}
|
||||||
|
|
||||||
if (!empty($_POST['submit_save_set'])) {
|
if (!empty($_POST['submit_save_set'])) {
|
||||||
|
@ -101,20 +104,25 @@ class Storage extends BaseAdmin
|
||||||
// build storage config form,
|
// build storage config form,
|
||||||
$storage_form_prefix = preg_replace('|[^a-zA-Z0-9]|', '', $name);
|
$storage_form_prefix = preg_replace('|[^a-zA-Z0-9]|', '', $name);
|
||||||
|
|
||||||
$storage_form = [];
|
$storage_form = [];
|
||||||
foreach (DI::storageManager()->getWritableStorageByName($name)->getOptions() as $option => $info) {
|
$storageConfig = DI::storageManager()->getConfigurationByName($name);
|
||||||
$type = $info[0];
|
|
||||||
// Backward compatibilty with yesno field description
|
|
||||||
if ($type == 'yesno') {
|
|
||||||
$type = 'checkbox';
|
|
||||||
// Remove translated labels Yes No from field info
|
|
||||||
unset($info[4]);
|
|
||||||
}
|
|
||||||
|
|
||||||
$info[0] = $storage_form_prefix . '_' . $option;
|
if ($storageConfig !== false) {
|
||||||
$info['type'] = $type;
|
foreach ($storageConfig->getOptions() as $option => $info) {
|
||||||
$info['field'] = 'field_' . $type . '.tpl';
|
|
||||||
$storage_form[$option] = $info;
|
$type = $info[0];
|
||||||
|
// Backward compatibilty with yesno field description
|
||||||
|
if ($type == 'yesno') {
|
||||||
|
$type = 'checkbox';
|
||||||
|
// Remove translated labels Yes No from field info
|
||||||
|
unset($info[4]);
|
||||||
|
}
|
||||||
|
|
||||||
|
$info[0] = $storage_form_prefix . '_' . $option;
|
||||||
|
$info['type'] = $type;
|
||||||
|
$info['field'] = 'field_' . $type . '.tpl';
|
||||||
|
$storage_form[$option] = $info;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
$available_storage_forms[] = [
|
$available_storage_forms[] = [
|
||||||
|
|
|
@ -23,11 +23,9 @@ namespace Friendica\Test\src\Model\Storage;
|
||||||
|
|
||||||
use Friendica\Factory\ConfigFactory;
|
use Friendica\Factory\ConfigFactory;
|
||||||
use Friendica\Model\Storage\Database;
|
use Friendica\Model\Storage\Database;
|
||||||
use Friendica\Model\Storage\IWritableStorage;
|
|
||||||
use Friendica\Test\DatabaseTestTrait;
|
use Friendica\Test\DatabaseTestTrait;
|
||||||
use Friendica\Test\Util\Database\StaticDatabase;
|
use Friendica\Test\Util\Database\StaticDatabase;
|
||||||
use Friendica\Test\Util\VFSTrait;
|
use Friendica\Test\Util\VFSTrait;
|
||||||
use Friendica\Util\ConfigFileLoader;
|
|
||||||
use Friendica\Util\Profiler;
|
use Friendica\Util\Profiler;
|
||||||
use Psr\Log\NullLogger;
|
use Psr\Log\NullLogger;
|
||||||
|
|
||||||
|
@ -47,7 +45,7 @@ class DatabaseStorageTest extends StorageTest
|
||||||
|
|
||||||
protected function getInstance()
|
protected function getInstance()
|
||||||
{
|
{
|
||||||
$logger = new NullLogger();
|
$logger = new NullLogger();
|
||||||
$profiler = \Mockery::mock(Profiler::class);
|
$profiler = \Mockery::mock(Profiler::class);
|
||||||
$profiler->shouldReceive('startRecording');
|
$profiler->shouldReceive('startRecording');
|
||||||
$profiler->shouldReceive('stopRecording');
|
$profiler->shouldReceive('stopRecording');
|
||||||
|
@ -55,19 +53,14 @@ class DatabaseStorageTest extends StorageTest
|
||||||
|
|
||||||
// load real config to avoid mocking every config-entry which is related to the Database class
|
// load real config to avoid mocking every config-entry which is related to the Database class
|
||||||
$configFactory = new ConfigFactory();
|
$configFactory = new ConfigFactory();
|
||||||
$loader = (new ConfigFactory())->createConfigFileLoader($this->root->url(), []);
|
$loader = (new ConfigFactory())->createConfigFileLoader($this->root->url(), []);
|
||||||
$configCache = $configFactory->createCache($loader);
|
$configCache = $configFactory->createCache($loader);
|
||||||
|
|
||||||
$dba = new StaticDatabase($configCache, $profiler, $logger);
|
$dba = new StaticDatabase($configCache, $profiler, $logger);
|
||||||
|
|
||||||
return new Database($dba);
|
return new Database($dba);
|
||||||
}
|
}
|
||||||
|
|
||||||
protected function assertOption(IWritableStorage $storage)
|
|
||||||
{
|
|
||||||
self::assertEmpty($storage->getOptions());
|
|
||||||
}
|
|
||||||
|
|
||||||
protected function tearDown(): void
|
protected function tearDown(): void
|
||||||
{
|
{
|
||||||
$this->tearDownDb();
|
$this->tearDownDb();
|
||||||
|
|
67
tests/src/Model/Storage/FilesystemStorageConfigTest.php
Normal file
67
tests/src/Model/Storage/FilesystemStorageConfigTest.php
Normal file
|
@ -0,0 +1,67 @@
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* @copyright Copyright (C) 2010-2021, the Friendica project
|
||||||
|
*
|
||||||
|
* @license GNU AGPL version 3 or any later version
|
||||||
|
*
|
||||||
|
* This program is free software: you can redistribute it and/or modify
|
||||||
|
* it under the terms of the GNU Affero General Public License as
|
||||||
|
* published by the Free Software Foundation, either version 3 of the
|
||||||
|
* License, or (at your option) any later version.
|
||||||
|
*
|
||||||
|
* This program is distributed in the hope that it will be useful,
|
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
* GNU Affero General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU Affero General Public License
|
||||||
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace Friendica\Test\src\Model\Storage;
|
||||||
|
|
||||||
|
use Friendica\Core\Config\IConfig;
|
||||||
|
use Friendica\Core\L10n;
|
||||||
|
use Friendica\Model\Storage\FilesystemConfig;
|
||||||
|
use Friendica\Model\Storage\IStorageConfiguration;
|
||||||
|
use Friendica\Test\Util\VFSTrait;
|
||||||
|
use Mockery\MockInterface;
|
||||||
|
use org\bovigo\vfs\vfsStream;
|
||||||
|
|
||||||
|
class FilesystemStorageConfigTest extends StorageConfigTest
|
||||||
|
{
|
||||||
|
use VFSTrait;
|
||||||
|
|
||||||
|
protected function setUp(): void
|
||||||
|
{
|
||||||
|
$this->setUpVfsDir();
|
||||||
|
|
||||||
|
vfsStream::create(['storage' => []], $this->root);
|
||||||
|
|
||||||
|
parent::setUp();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function getInstance()
|
||||||
|
{
|
||||||
|
/** @var MockInterface|L10n $l10n */
|
||||||
|
$l10n = \Mockery::mock(L10n::class)->makePartial();
|
||||||
|
$config = \Mockery::mock(IConfig::class);
|
||||||
|
$config->shouldReceive('get')
|
||||||
|
->with('storage', 'filesystem_path', FilesystemConfig::DEFAULT_BASE_FOLDER)
|
||||||
|
->andReturn($this->root->getChild('storage')->url());
|
||||||
|
|
||||||
|
return new FilesystemConfig($config, $l10n);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function assertOption(IStorageConfiguration $storage)
|
||||||
|
{
|
||||||
|
self::assertEquals([
|
||||||
|
'storagepath' => [
|
||||||
|
'input', 'Storage base path',
|
||||||
|
$this->root->getChild('storage')->url(),
|
||||||
|
'Folder where uploaded files are saved. For maximum security, This should be a path outside web server folder tree'
|
||||||
|
]
|
||||||
|
], $storage->getOptions());
|
||||||
|
}
|
||||||
|
}
|
|
@ -21,23 +21,15 @@
|
||||||
|
|
||||||
namespace Friendica\Test\src\Model\Storage;
|
namespace Friendica\Test\src\Model\Storage;
|
||||||
|
|
||||||
use Friendica\Core\Config\IConfig;
|
|
||||||
use Friendica\Core\L10n;
|
|
||||||
use Friendica\Model\Storage\Filesystem;
|
use Friendica\Model\Storage\Filesystem;
|
||||||
use Friendica\Model\Storage\IWritableStorage;
|
|
||||||
use Friendica\Model\Storage\StorageException;
|
use Friendica\Model\Storage\StorageException;
|
||||||
use Friendica\Test\Util\VFSTrait;
|
use Friendica\Test\Util\VFSTrait;
|
||||||
use Friendica\Util\Profiler;
|
|
||||||
use Mockery\MockInterface;
|
|
||||||
use org\bovigo\vfs\vfsStream;
|
use org\bovigo\vfs\vfsStream;
|
||||||
|
|
||||||
class FilesystemStorageTest extends StorageTest
|
class FilesystemStorageTest extends StorageTest
|
||||||
{
|
{
|
||||||
use VFSTrait;
|
use VFSTrait;
|
||||||
|
|
||||||
/** @var MockInterface|IConfig */
|
|
||||||
protected $config;
|
|
||||||
|
|
||||||
protected function setUp(): void
|
protected function setUp(): void
|
||||||
{
|
{
|
||||||
$this->setUpVfsDir();
|
$this->setUpVfsDir();
|
||||||
|
@ -49,30 +41,7 @@ class FilesystemStorageTest extends StorageTest
|
||||||
|
|
||||||
protected function getInstance()
|
protected function getInstance()
|
||||||
{
|
{
|
||||||
$profiler = \Mockery::mock(Profiler::class);
|
return new Filesystem($this->root->getChild('storage')->url());
|
||||||
$profiler->shouldReceive('startRecording');
|
|
||||||
$profiler->shouldReceive('stopRecording');
|
|
||||||
$profiler->shouldReceive('saveTimestamp')->withAnyArgs()->andReturn(true);
|
|
||||||
|
|
||||||
/** @var MockInterface|L10n $l10n */
|
|
||||||
$l10n = \Mockery::mock(L10n::class)->makePartial();
|
|
||||||
$this->config = \Mockery::mock(IConfig::class);
|
|
||||||
$this->config->shouldReceive('get')
|
|
||||||
->with('storage', 'filesystem_path', Filesystem::DEFAULT_BASE_FOLDER)
|
|
||||||
->andReturn($this->root->getChild('storage')->url());
|
|
||||||
|
|
||||||
return new Filesystem($this->config, $l10n);
|
|
||||||
}
|
|
||||||
|
|
||||||
protected function assertOption(IWritableStorage $storage)
|
|
||||||
{
|
|
||||||
self::assertEquals([
|
|
||||||
'storagepath' => [
|
|
||||||
'input', 'Storage base path',
|
|
||||||
$this->root->getChild('storage')->url(),
|
|
||||||
'Folder where uploaded files are saved. For maximum security, This should be a path outside web server folder tree'
|
|
||||||
]
|
|
||||||
], $storage->getOptions());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -116,7 +85,7 @@ class FilesystemStorageTest extends StorageTest
|
||||||
|
|
||||||
$instance->put('test', 'f0c0d0i0');
|
$instance->put('test', 'f0c0d0i0');
|
||||||
|
|
||||||
$dir = $this->root->getChild('storage/f0/c0')->url();
|
$dir = $this->root->getChild('storage/f0/c0')->url();
|
||||||
$file = $this->root->getChild('storage/f0/c0/d0i0')->url();
|
$file = $this->root->getChild('storage/f0/c0/d0i0')->url();
|
||||||
|
|
||||||
self::assertDirectoryExists($dir);
|
self::assertDirectoryExists($dir);
|
||||||
|
|
43
tests/src/Model/Storage/StorageConfigTest.php
Normal file
43
tests/src/Model/Storage/StorageConfigTest.php
Normal file
|
@ -0,0 +1,43 @@
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* @copyright Copyright (C) 2010-2021, the Friendica project
|
||||||
|
*
|
||||||
|
* @license GNU AGPL version 3 or any later version
|
||||||
|
*
|
||||||
|
* This program is free software: you can redistribute it and/or modify
|
||||||
|
* it under the terms of the GNU Affero General Public License as
|
||||||
|
* published by the Free Software Foundation, either version 3 of the
|
||||||
|
* License, or (at your option) any later version.
|
||||||
|
*
|
||||||
|
* This program is distributed in the hope that it will be useful,
|
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
* GNU Affero General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU Affero General Public License
|
||||||
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace Friendica\Test\src\Model\Storage;
|
||||||
|
|
||||||
|
use Friendica\Model\Storage\IStorageConfiguration;
|
||||||
|
use Friendica\Test\MockedTest;
|
||||||
|
|
||||||
|
abstract class StorageConfigTest extends MockedTest
|
||||||
|
{
|
||||||
|
/** @return IStorageConfiguration */
|
||||||
|
abstract protected function getInstance();
|
||||||
|
|
||||||
|
abstract protected function assertOption(IStorageConfiguration $storage);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test if the "getOption" is asserted
|
||||||
|
*/
|
||||||
|
public function testGetOptions()
|
||||||
|
{
|
||||||
|
$instance = $this->getInstance();
|
||||||
|
|
||||||
|
$this->assertOption($instance);
|
||||||
|
}
|
||||||
|
}
|
|
@ -31,8 +31,6 @@ abstract class StorageTest extends MockedTest
|
||||||
/** @return IWritableStorage */
|
/** @return IWritableStorage */
|
||||||
abstract protected function getInstance();
|
abstract protected function getInstance();
|
||||||
|
|
||||||
abstract protected function assertOption(IWritableStorage $storage);
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Test if the instance is "really" implementing the interface
|
* Test if the instance is "really" implementing the interface
|
||||||
*/
|
*/
|
||||||
|
@ -42,16 +40,6 @@ abstract class StorageTest extends MockedTest
|
||||||
self::assertInstanceOf(IStorage::class, $instance);
|
self::assertInstanceOf(IStorage::class, $instance);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Test if the "getOption" is asserted
|
|
||||||
*/
|
|
||||||
public function testGetOptions()
|
|
||||||
{
|
|
||||||
$instance = $this->getInstance();
|
|
||||||
|
|
||||||
$this->assertOption($instance);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Test basic put, get and delete operations
|
* Test basic put, get and delete operations
|
||||||
*/
|
*/
|
||||||
|
|
Loading…
Reference in a new issue