phpmyadmin/libraries/classes/Config/Forms/BaseFormList.php
Kamil Tekiela d1bda5c5dc Refactor config forms
Signed-off-by: Kamil Tekiela <tekiela246@gmail.com>
2023-01-23 23:32:27 +00:00

140 lines
2.8 KiB
PHP

<?php
/**
* User preferences form
*/
declare(strict_types=1);
namespace PhpMyAdmin\Config\Forms;
use PhpMyAdmin\Config\ConfigFile;
use function array_key_exists;
use function array_keys;
use function array_merge;
class BaseFormList
{
/**
* List of all forms
*
* @var array<string, class-string<BaseForm>>
*/
protected static $all = [];
/** @var BaseForm[] */
private $forms;
/**
* @return string[]
*/
public static function getAllFormNames()
{
return array_keys(static::$all);
}
/**
* @param string $name Name
*/
public static function isValid(string $name): bool
{
return array_key_exists($name, static::$all);
}
/**
* @param string $name Name
*
* @return string|null
* @psalm-return class-string<BaseForm>|null
*/
public static function get(string $name)
{
if (static::isValid($name)) {
return static::$all[$name];
}
return null;
}
/**
* @param ConfigFile $cf Config file instance
*/
final public function __construct(ConfigFile $cf)
{
$this->forms = [];
foreach (static::$all as $class) {
$this->forms[] = new $class($cf);
}
}
/**
* Processes forms, returns true on successful save
*
* @param bool $allowPartialSave allows for partial form saving
* on failed validation
* @param bool $checkFormSubmit whether check for $_POST['submit_save']
*/
public function process($allowPartialSave = true, $checkFormSubmit = true): bool
{
$ret = true;
foreach ($this->forms as $form) {
$ret = $ret && $form->process($allowPartialSave, $checkFormSubmit);
}
return $ret;
}
/**
* Displays errors
*
* @return string HTML for errors
*/
public function displayErrors()
{
$ret = '';
foreach ($this->forms as $form) {
$ret .= $form->displayErrors();
}
return $ret;
}
/**
* Reverts erroneous fields to their default values
*/
public function fixErrors(): void
{
foreach ($this->forms as $form) {
$form->fixErrors();
}
}
/**
* Tells whether form validation failed
*/
public function hasErrors(): bool
{
$ret = false;
foreach ($this->forms as $form) {
$ret = $ret || $form->hasErrors();
}
return $ret;
}
/**
* Returns list of fields used in the form.
*
* @return string[]
*/
public static function getFields()
{
$names = [];
foreach (static::$all as $class) {
$names = array_merge($names, $class::getFields());
}
return $names;
}
}