class SystemStateEdit
Same name in other branches
- 4.x src/Form/SystemStateEdit.php \Drupal\devel\Form\SystemStateEdit
Form API form to edit a state.
Hierarchy
- class \Drupal\Core\Form\FormBase implements \Drupal\Core\Form\FormInterface, \Drupal\Core\DependencyInjection\ContainerInjectionInterface uses \Drupal\Core\DependencyInjection\DependencySerializationTrait, \Drupal\Core\Logger\LoggerChannelTrait, \Drupal\Core\Messenger\MessengerTrait, \Drupal\Core\Routing\RedirectDestinationTrait, \Drupal\Core\StringTranslation\StringTranslationTrait
- class \Drupal\devel\Form\SystemStateEdit extends \Drupal\Core\Form\FormBase
Expanded class hierarchy of SystemStateEdit
1 string reference to 'SystemStateEdit'
File
-
src/
Form/ SystemStateEdit.php, line 18
Namespace
Drupal\devel\FormView source
class SystemStateEdit extends FormBase {
/**
* The state store.
*/
protected StateInterface $state;
/**
* Logger service.
*/
protected LoggerInterface $logger;
/**
* The dumper service.
*/
protected DevelDumperManagerInterface $dumper;
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container) : static {
$instance = parent::create($container);
$instance->state = $container->get('state');
$instance->messenger = $container->get('messenger');
$instance->logger = $container->get('logger.channel.devel');
$instance->stringTranslation = $container->get('string_translation');
$instance->dumper = $container->get('devel.dumper');
return $instance;
}
/**
* {@inheritdoc}
*/
public function getFormId() : string {
return 'devel_state_system_edit_form';
}
/**
* {@inheritdoc}
*/
public function buildForm(array $form, FormStateInterface $form_state, $state_name = '') : array {
// Get the old value.
$old_value = $this->state
->get($state_name);
if (!isset($old_value)) {
$this->messenger
->addWarning($this->t('State @name does not exist in the system.', [
'@name' => $state_name,
]));
return $form;
}
// Only simple structures are allowed to be edited.
$disabled = !$this->checkObject($old_value);
if ($disabled) {
$this->messenger
->addWarning($this->t('Only simple structures are allowed to be edited. State @name contains objects.', [
'@name' => $state_name,
]));
}
// First we show the user the content of the variable about to be edited.
$form['value'] = [
'#type' => 'item',
'#title' => $this->t('Current value for %name', [
'%name' => $state_name,
]),
'#markup' => $this->dumper
->dumpOrExport(input: $old_value),
];
$transport = 'plain';
if (!$disabled && is_array($old_value)) {
try {
$old_value = Yaml::encode($old_value);
$transport = 'yaml';
} catch (InvalidDataTypeException $e) {
$this->messenger
->addError($this->t('Invalid data detected for @name : %error', [
'@name' => $state_name,
'%error' => $e->getMessage(),
]));
return $form;
}
}
// Store in the form the name of the state variable.
$form['state_name'] = [
'#type' => 'value',
'#value' => $state_name,
];
// Set the transport format for the new value. Values:
// - plain
// - yaml.
$form['transport'] = [
'#type' => 'value',
'#value' => $transport,
];
$form['new_value'] = [
'#type' => 'textarea',
'#title' => $this->t('New value'),
'#default_value' => $disabled ? '' : $old_value,
'#disabled' => $disabled,
'#rows' => 15,
];
$form['actions'] = [
'#type' => 'actions',
];
$form['actions']['submit'] = [
'#type' => 'submit',
'#value' => $this->t('Save'),
'#disabled' => $disabled,
];
$form['actions']['cancel'] = [
'#type' => 'link',
'#title' => $this->t('Cancel'),
'#url' => Url::fromRoute('devel.state_system_page'),
];
return $form;
}
/**
* {@inheritdoc}
*/
public function validateForm(array &$form, FormStateInterface $form_state) : void {
$values = $form_state->getValues();
if ($values['transport'] == 'yaml') {
// Try to parse the new provided value.
try {
$parsed_value = Yaml::decode($values['new_value']);
$form_state->setValue('parsed_value', $parsed_value);
} catch (InvalidDataTypeException $e) {
$form_state->setErrorByName('new_value', $this->t('Invalid input: %error', [
'%error' => $e->getMessage(),
]));
}
}
else {
$form_state->setValue('parsed_value', $values['new_value']);
}
}
/**
* {@inheritdoc}
*/
public function submitForm(array &$form, FormStateInterface $form_state) : void {
// Save the state.
$values = $form_state->getValues();
$this->state
->set($values['state_name'], $values['parsed_value']);
$form_state->setRedirectUrl(Url::fromRoute('devel.state_system_page'));
$this->messenger
->addMessage($this->t('Variable %variable was successfully edited.', [
'%variable' => $values['state_name'],
]));
$this->logger
->info('Variable %variable was successfully edited.', [
'%variable' => $values['state_name'],
]);
}
/**
* Helper function to determine if a variable is or contains an object.
*
* @param mixed $data
* Input data to check.
*
* @return bool
* TRUE if the variable is not an object and does not contain one.
*/
protected function checkObject(mixed $data) : bool {
if (is_object($data)) {
return FALSE;
}
if (is_array($data)) {
// If the current object is an array, then check recursively.
foreach ($data as $value) {
// If there is an object the whole container is "contaminated".
if (!$this->checkObject($value)) {
return FALSE;
}
}
}
// All checks pass.
return TRUE;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
DependencySerializationTrait::$_entityStorages | protected | property | |||
DependencySerializationTrait::$_serviceIds | protected | property | |||
DependencySerializationTrait::__sleep | public | function | 1 | ||
DependencySerializationTrait::__wakeup | public | function | 2 | ||
FormBase::$configFactory | protected | property | The config factory. | 3 | |
FormBase::$requestStack | protected | property | The request stack. | 1 | |
FormBase::$routeMatch | protected | property | The route match. | ||
FormBase::config | protected | function | Retrieves a configuration object. | ||
FormBase::configFactory | protected | function | Gets the config factory for this form. | 3 | |
FormBase::container | private | function | Returns the service container. | ||
FormBase::currentUser | protected | function | Gets the current user. | 2 | |
FormBase::getRequest | protected | function | Gets the request object. | ||
FormBase::getRouteMatch | protected | function | Gets the route match. | ||
FormBase::logger | protected | function | Gets the logger for a specific channel. | ||
FormBase::redirect | protected | function | Returns a redirect response object for the specified route. | ||
FormBase::resetConfigFactory | public | function | Resets the configuration factory. | ||
FormBase::setConfigFactory | public | function | Sets the config factory for this form. | ||
FormBase::setRequestStack | public | function | Sets the request stack object to use. | ||
LoggerChannelTrait::$loggerFactory | protected | property | The logger channel factory service. | ||
LoggerChannelTrait::getLogger | protected | function | Gets the logger for a specific channel. | ||
LoggerChannelTrait::setLoggerFactory | public | function | Injects the logger channel factory. | ||
MessengerTrait::$messenger | protected | property | The messenger. | 16 | |
MessengerTrait::messenger | public | function | Gets the messenger. | 16 | |
MessengerTrait::setMessenger | public | function | Sets the messenger. | ||
RedirectDestinationTrait::$redirectDestination | protected | property | The redirect destination service. | 2 | |
RedirectDestinationTrait::getDestinationArray | protected | function | Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url. | ||
RedirectDestinationTrait::getRedirectDestination | protected | function | Returns the redirect destination service. | ||
RedirectDestinationTrait::setRedirectDestination | public | function | Sets the redirect destination service. | ||
StringTranslationTrait::$stringTranslation | protected | property | The string translation service. | 3 | |
StringTranslationTrait::formatPlural | protected | function | Formats a string containing a count of items. | ||
StringTranslationTrait::getNumberOfPlurals | protected | function | Returns the number of plurals supported by a given language. | ||
StringTranslationTrait::getStringTranslation | protected | function | Gets the string translation service. | ||
StringTranslationTrait::setStringTranslation | public | function | Sets the string translation service to use. | 2 | |
StringTranslationTrait::t | protected | function | Translates a string to the current language or to a given language. | ||
SystemStateEdit::$dumper | protected | property | The dumper service. | ||
SystemStateEdit::$logger | protected | property | Logger service. | ||
SystemStateEdit::$state | protected | property | The state store. | ||
SystemStateEdit::buildForm | public | function | Form constructor. | Overrides FormInterface::buildForm | |
SystemStateEdit::checkObject | protected | function | Helper function to determine if a variable is or contains an object. | ||
SystemStateEdit::create | public static | function | Instantiates a new instance of this class. | Overrides FormBase::create | |
SystemStateEdit::getFormId | public | function | Returns a unique string identifying the form. | Overrides FormInterface::getFormId | |
SystemStateEdit::submitForm | public | function | Form submission handler. | Overrides FormInterface::submitForm | |
SystemStateEdit::validateForm | public | function | Form validation handler. | Overrides FormBase::validateForm |