FormPersistenceManager

class \TYPO3\CMS\Form\Mvc\Persistence\FormPersistenceManager

Implements
FormPersistenceManagerInterface

Concrete implementation of the FormPersistenceManagerInterface

Scope: frontend / backend

Table of Contents

Interfaces

FormPersistenceManagerInterface
The form persistence manager interface

Constants

FORM_DEFINITION_FILE_EXTENSION  : mixed = '.form.yaml'

Properties

$filePersistenceSlot  : FilePersistenceSlot
$formSettings  : array
$resourceFactory  : ResourceFactory
$runtimeCache  : FrontendInterface
$storageRepository  : StorageRepository
$yamlSource  : YamlSource

Methods

__construct()  : mixed
checkForDuplicateIdentifier()  : bool
Check if an identifier is already used by a formDefinition.
delete()  : mixed
Delete the form representation identified by $persistenceIdentifier.
exists()  : bool
Check whether a form with the specified $persistenceIdentifier exists
getAccessibleExtensionFolders()  : array
Return a list of all accessible extension folders
getAccessibleFormStorageFolders()  : Folder[]
Return a list of all accessible file mountpoints for the current backend user.
getUniqueIdentifier()  : string
This takes a form identifier and returns a unique identifier for it.
getUniquePersistenceIdentifier()  : string
This takes a form identifier and returns a unique persistence identifier for it.
hasValidFileExtension()  : bool
isAllowedPersistencePath()  : bool
Check if a persistence path or if a persistence identifier path is configured within the form setup (TYPO3.CMS.Form.persistenceManager.allowedExtensionPaths / TYPO3.CMS.Form.persistenceManager.allowedFileMounts).
listForms()  : array
List all form definitions which can be loaded through this form persistence manager.
load()  : array
Load the array formDefinition identified by $persistenceIdentifier, and return it.
retrieveYamlFilesFromExtensionFolders()  : array<string, string>
Retrieves yaml files from extension folders for further processing.
retrieveYamlFilesFromStorageFolders()  : File[]
Retrieves yaml files from storage folders for further processing.
save()  : mixed
Save the array form representation identified by $persistenceIdentifier.
ensureValidPersistenceIdentifier()  : void
extractMetaDataFromCouldBeFormDefinition()  : array
generateErrorsIfFormDefinitionIsValidButHasInvalidFileExtension()  : void
getOrCreateFile()  : File
Returns a File object for a given $persistenceIdentifier.
getStorageByUid()  : ResourceStorage
Returns a ResourceStorage for a given uid
isAccessibleExtensionFolder()  : bool
isAccessibleFormStorageFolder()  : bool
isFileWithinAccessibleExtensionFolders()  : bool
isFileWithinAccessibleFormStorageFolders()  : bool
loadMetaData()  : array
looksLikeAFormDefinition()  : bool
pathIsIntendedAsExtensionPath()  : bool
pathIsIntendedAsFileMountPath()  : bool
retrieveFileByPersistenceIdentifier()  : File
sortForms()  : array

Constants

FORM_DEFINITION_FILE_EXTENSION

public mixed FORM_DEFINITION_FILE_EXTENSION = '.form.yaml'

Properties

$formSettings

protected array $formSettings

Methods

__construct()

public __construct(YamlSource $yamlSource, StorageRepository $storageRepository, FilePersistenceSlot $filePersistenceSlot, ResourceFactory $resourceFactory, ConfigurationManagerInterface $configurationManager, CacheManager $cacheManager) : mixed

Parameters

$yamlSource : YamlSource
$storageRepository : StorageRepository
$filePersistenceSlot : FilePersistenceSlot
$resourceFactory : ResourceFactory
$configurationManager : ConfigurationManagerInterface
$cacheManager : CacheManager

checkForDuplicateIdentifier()

Check if an identifier is already used by a formDefinition.

public checkForDuplicateIdentifier(string $identifier) : bool

Parameters

$identifier : string

Return values

bool

delete()

Delete the form representation identified by $persistenceIdentifier.

public delete(string $persistenceIdentifier) : mixed

Only files with the extension .form.yaml are removed.

Parameters

$persistenceIdentifier : string

Tags

throws
PersistenceManagerException

exists()

Check whether a form with the specified $persistenceIdentifier exists

public exists(string $persistenceIdentifier) : bool

Parameters

$persistenceIdentifier : string

Return values

bool —

TRUE if a form with the given $persistenceIdentifier can be loaded, otherwise FALSE

getAccessibleExtensionFolders()

Return a list of all accessible extension folders

public getAccessibleExtensionFolders() : array

Only registered mountpoints from TYPO3.CMS.Form.persistenceManager.allowedExtensionPaths are listed.

Return values

array

getAccessibleFormStorageFolders()

Return a list of all accessible file mountpoints for the current backend user.

public getAccessibleFormStorageFolders() : Folder[]

Only registered mountpoints from TYPO3.CMS.Form.persistenceManager.allowedFileMounts are listed.

Return values

Folder[]

getUniqueIdentifier()

This takes a form identifier and returns a unique identifier for it.

public getUniqueIdentifier(string $identifier) : string

If a formDefinition with the same identifier already exists a suffix is appended until the identifier is unique.

Parameters

$identifier : string

Tags

throws
NoUniqueIdentifierException

Return values

string —

unique form identifier

getUniquePersistenceIdentifier()

This takes a form identifier and returns a unique persistence identifier for it.

public getUniquePersistenceIdentifier(string $formIdentifier, string $savePath) : string

By default this is just similar to the identifier. But if a form with the same persistence identifier already exists a suffix is appended until the persistence identifier is unique.

Parameters

$formIdentifier : string

lowerCamelCased form identifier

$savePath : string

Tags

throws
NoUniquePersistenceIdentifierException

Return values

string —

unique form persistence identifier

hasValidFileExtension()

public hasValidFileExtension(string $fileName) : bool

Parameters

$fileName : string

Return values

bool

isAllowedPersistencePath()

Check if a persistence path or if a persistence identifier path is configured within the form setup (TYPO3.CMS.Form.persistenceManager.allowedExtensionPaths / TYPO3.CMS.Form.persistenceManager.allowedFileMounts).

public isAllowedPersistencePath(string $persistencePath) : bool

If the input is a persistence identifier an additional check for a valid file extension will be performed. .

Parameters

$persistencePath : string

Return values

bool

listForms()

List all form definitions which can be loaded through this form persistence manager.

public listForms() : array

Returns an associative array with each item containing the keys 'name' (the human-readable name of the form) and 'persistenceIdentifier' (the unique identifier for the Form Persistence Manager e.g. the path to the saved form definition).

Return values

array —

in the format [['name' => 'Form 01', 'persistenceIdentifier' => 'path1'], [ .... ]]

load()

Load the array formDefinition identified by $persistenceIdentifier, and return it.

public load(string $persistenceIdentifier) : array

Only files with the extension .yaml or .form.yaml are loaded.

Parameters

$persistenceIdentifier : string

Return values

array

retrieveYamlFilesFromExtensionFolders()

Retrieves yaml files from extension folders for further processing.

public retrieveYamlFilesFromExtensionFolders() : array<string, string>

At this time it's not determined yet, whether these files contain form data.

Return values

array<string, string>

retrieveYamlFilesFromStorageFolders()

Retrieves yaml files from storage folders for further processing.

public retrieveYamlFilesFromStorageFolders() : File[]

At this time it's not determined yet, whether these files contain form data.

Return values

File[]

save()

Save the array form representation identified by $persistenceIdentifier.

public save(string $persistenceIdentifier, array $formDefinition) : mixed

Only files with the extension .form.yaml are saved. If the formDefinition is located within an EXT: resource, save is only allowed if the configuration path TYPO3.CMS.Form.persistenceManager.allowSaveToExtensionPaths is set to true.

Parameters

$persistenceIdentifier : string
$formDefinition : array

Tags

throws
PersistenceManagerException

extractMetaDataFromCouldBeFormDefinition()

protected extractMetaDataFromCouldBeFormDefinition(string $maybeRawFormDefinition) : array

Parameters

$maybeRawFormDefinition : string

Return values

array

generateErrorsIfFormDefinitionIsValidButHasInvalidFileExtension()

protected generateErrorsIfFormDefinitionIsValidButHasInvalidFileExtension(array $formDefinition, string $persistenceIdentifier) : void

Parameters

$formDefinition : array
$persistenceIdentifier : string

Tags

throws
PersistenceManagerException

getOrCreateFile()

Returns a File object for a given $persistenceIdentifier.

protected getOrCreateFile(string $persistenceIdentifier) : File

If no file for this identifier exists a new object will be created.

Parameters

$persistenceIdentifier : string

Tags

throws
PersistenceManagerException

Return values

File

isAccessibleExtensionFolder()

protected isAccessibleExtensionFolder(string $folderName) : bool

Parameters

$folderName : string

Return values

bool

isAccessibleFormStorageFolder()

protected isAccessibleFormStorageFolder(string $folderName) : bool

Parameters

$folderName : string

Return values

bool

isFileWithinAccessibleExtensionFolders()

protected isFileWithinAccessibleExtensionFolders(string $fileName) : bool

Parameters

$fileName : string

Return values

bool

isFileWithinAccessibleFormStorageFolders()

protected isFileWithinAccessibleFormStorageFolders(string $fileName) : bool

Parameters

$fileName : string

Return values

bool

loadMetaData()

protected loadMetaData(string|File $persistenceIdentifier) : array

Parameters

$persistenceIdentifier : string|File

Tags

throws
NoSuchFileException

Return values

array

looksLikeAFormDefinition()

protected looksLikeAFormDefinition(array $data) : bool

Parameters

$data : array

Return values

bool

pathIsIntendedAsExtensionPath()

protected pathIsIntendedAsExtensionPath(string $path) : bool

Parameters

$path : string

Return values

bool

pathIsIntendedAsFileMountPath()

protected pathIsIntendedAsFileMountPath(string $path) : bool

Parameters

$path : string

Return values

bool

sortForms()

protected sortForms(array $forms) : array

Parameters

$forms : array

Return values

array
On this page