FormPersistenceManager implements FormPersistenceManagerInterface
Form Persistence Manager - Entry point for FormManagerController
This manager acts as a facade that delegates storage operations to appropriate storage adapters via the StorageAdapterFactory.
Scope: frontend / backend
Attributes
- #[AsAlias]
- \TYPO3\CMS\Form\Mvc\Persistence\FormPersistenceManagerInterface::class
Table of Contents
Interfaces
- FormPersistenceManagerInterface
- The form persistence manager interface
Methods
- __construct() : mixed
- delete() : void
- Delete form definition from storage
- getAccessibleExtensionFolders() : array<string|int, mixed>
- Get accessible extension folders Delegates to FileStorageAdapter
- getAccessibleFormStorageFolders() : array<string|int, Folder>
- Get accessible form storage folders Delegates to FileStorageAdapter
- getUniqueIdentifier() : string
- Get unique identifier (not persistence identifier)
- getUniquePersistenceIdentifier() : string
- Get unique persistence identifier for a new form
- hasForms() : bool
- Check if any forms are available
- hasValidFileExtension() : bool
- Check if file has valid extension
- isAllowedPersistencePath() : bool
- Check if persistence path is allowed
- listForms() : array<string|int, mixed>
- List all form definitions from all available storages
- load() : array<string|int, mixed>
- Load form definition and apply event listeners and TypoScript overrides
- save() : void
- Save form definition to appropriate storage
- sortForms() : array<string|int, mixed>
Methods
__construct()
public
__construct(StorageAdapterFactory $storageAdapterFactory, FrontendInterface $runtimeCache, EventDispatcherInterface $eventDispatcher, TypoScriptService $typoScriptService) : mixed
Parameters
- $storageAdapterFactory : StorageAdapterFactory
- $runtimeCache : FrontendInterface
- $eventDispatcher : EventDispatcherInterface
- $typoScriptService : TypoScriptService
delete()
Delete form definition from storage
public
delete(string $persistenceIdentifier, array<string|int, mixed> $formSettings) : void
Parameters
- $persistenceIdentifier : string
- $formSettings : array<string|int, mixed>
getAccessibleExtensionFolders()
Get accessible extension folders Delegates to FileStorageAdapter
public
getAccessibleExtensionFolders(array<string|int, mixed> $formSettings) : array<string|int, mixed>
Parameters
- $formSettings : array<string|int, mixed>
Return values
array<string|int, mixed>getAccessibleFormStorageFolders()
Get accessible form storage folders Delegates to FileStorageAdapter
public
getAccessibleFormStorageFolders(array<string|int, mixed> $formSettings) : array<string|int, Folder>
Parameters
- $formSettings : array<string|int, mixed>
Return values
array<string|int, Folder>getUniqueIdentifier()
Get unique identifier (not persistence identifier)
public
getUniqueIdentifier(array<string|int, mixed> $formSettings, string $identifier) : string
Parameters
- $formSettings : array<string|int, mixed>
- $identifier : string
Return values
stringgetUniquePersistenceIdentifier()
Get unique persistence identifier for a new form
public
getUniquePersistenceIdentifier(string $formIdentifier, string $savePath, array<string|int, mixed> $formSettings) : string
Parameters
- $formIdentifier : string
- $savePath : string
- $formSettings : array<string|int, mixed>
Return values
stringhasForms()
Check if any forms are available
public
hasForms(array<string|int, mixed> $formSettings) : bool
Parameters
- $formSettings : array<string|int, mixed>
Return values
boolhasValidFileExtension()
Check if file has valid extension
public
hasValidFileExtension(string $fileName) : bool
Parameters
- $fileName : string
Return values
boolisAllowedPersistencePath()
Check if persistence path is allowed
public
isAllowedPersistencePath(string $persistencePath, array<string|int, mixed> $formSettings) : bool
Parameters
- $persistencePath : string
- $formSettings : array<string|int, mixed>
Return values
boollistForms()
List all form definitions from all available storages
public
listForms(array<string|int, mixed> $formSettings, SearchCriteria $searchCriteria) : array<string|int, mixed>
Parameters
- $formSettings : array<string|int, mixed>
- $searchCriteria : SearchCriteria
Return values
array<string|int, mixed> —in the format [['name' => 'Form 01', 'persistenceIdentifier' => 'path1'], [ .... ]]
load()
Load form definition and apply event listeners and TypoScript overrides
public
load(string $persistenceIdentifier[, array<string|int, mixed>|null $typoScriptSettings = null ][, ServerRequestInterface|null $request = null ]) : array<string|int, mixed>
Parameters
- $persistenceIdentifier : string
- $typoScriptSettings : array<string|int, mixed>|null = null
-
FE TS "plugin.tx_form.settings" - Given when rendering a form as plugin using FormFrontendController or formvh:render, empty array in all BE usages. Intended to override details like labels of single forms.
- $request : ServerRequestInterface|null = null
Return values
array<string|int, mixed>save()
Save form definition to appropriate storage
public
save(string $persistenceIdentifier, array<string|int, mixed> $formDefinition, array<string|int, mixed> $formSettings) : void
Parameters
- $persistenceIdentifier : string
- $formDefinition : array<string|int, mixed>
- $formSettings : array<string|int, mixed>
sortForms()
protected
sortForms(array<string|int, mixed> $forms, array<string|int, mixed> $formSettings[, string $orderField = '' ][, string|null $orderDirection = null ]) : array<string|int, mixed>
Parameters
- $forms : array<string|int, mixed>
- $formSettings : array<string|int, mixed>
- $orderField : string = ''
- $orderDirection : string|null = null