FlexDirectoryForm
in package
implements
FlexDirectoryFormInterface, JsonSerializable
uses
NestedArrayAccessWithGetters, FormTrait
Class FlexForm
Table of Contents
Interfaces
- FlexDirectoryFormInterface
- Defines Forms for Flex Objects.
- JsonSerializable
Properties
- $message : string|null
- $messages : array<string|int, string>
- $status : string
- $blueprint : Blueprint
- $data : ArrayAccess<string, mixed>|Data|null
- $directory : FlexDirectory
- $enabled : bool
- $files : array<string|int, UploadedFileInterface>
- $flash : FormFlashInterface|null
- $flashFolder : string
- $flexName : string
- $form : array<string|int, mixed>|null
- $id : string
- $name : string
- $sessionid : string
- $submitted : bool
- $uniqueid : string
Methods
- __construct() : mixed
- FlexForm constructor.
- __get() : mixed|null
- __isset() : bool
- __serialize() : array<string|int, mixed>
- __set() : void
- __unserialize() : void
- __unset() : void
- disable() : void
- enable() : void
- get() : mixed
- getAction() : string
- getAllFlashes() : array<string|int, FormFlashInterface>
- Get all available form flash objects for this form.
- getBlueprint() : Blueprint
- Get blueprint used in the form.
- getButtons() : array<string|int, mixed>
- getData() : Data|object
- Get current data passed to the form.
- getDefaultValue() : array<string|int, mixed>|mixed|null
- getDefaultValues() : array<string|int, mixed>
- getDirectory() : FlexDirectory
- Get object associated to the form.
- getError() : string|null
- getErrors() : array<string|int, mixed>
- getFields() : array<string|int, mixed>
- getFileDeleteAjaxRoute() : Route|null
- Get route for deleting files by AJAX.
- getFiles() : array<string|int, mixed>|array<string|int, UploadedFileInterface>
- getFileUploadAjaxRoute() : Route|null
- Get route for uploading files by AJAX.
- getFlash() : FormFlashInterface|FlexFormFlash
- Get form flash object.
- getFlexType() : string
- getFormName() : string
- getId() : string
- getMediaTaskRoute() : string
- Get media task route.
- getName() : string
- getNonce() : string
- getNonceAction() : string
- getNonceName() : string
- getTask() : string
- getTasks() : array<string|int, mixed>
- getUniqueId() : string
- getValue() : mixed
- Get a value from the form.
- handleRequest() : FormInterface|$this
- initialize() : $this
- instance() : FlexFormInterface
- isEnabled() : bool
- isSubmitted() : bool
- isValid() : bool
- jsonSerialize() : array<string|int, mixed>
- render() : mixed
- {@inheritdoc}
- reset() : void
- set() : $this
- setId() : void
- setRequest() : FormInterface|$this
- setUniqueId() : void
- Sets unique form id.
- submit() : FormInterface|$this
- validate() : bool
- decodeData() : array<string|int, mixed>
- Decode POST data
- doSerialize() : array<string|int, mixed>
- doSubmit() : void
- doUnserialize() : void
- filterData() : void
- Filter validated data.
- getFlashFolder() : string|null
- getFlashId() : string|null
- getFlashLookupFolder() : string
- getSessionId() : string
- getTemplate() : Template|TemplateWrapper
- getUnserializeAllowedClasses() : array<string|int, mixed>|bool
- jsonDecode() : array<string|int, mixed>
- Recursively JSON decode POST data.
- parseRequest() : array<string|int, mixed>
- Parse PSR-7 ServerRequest into data and files.
- setDirectory() : $this
- Note: this method clones the object.
- setError() : void
- Set a single error.
- setErrors() : void
- Set all errors.
- setFlashLookupFolder() : void
- setName() : void
- setSessionId() : void
- unsetFlash() : void
- validateData() : void
- Validate data and throw validation exceptions if validation fails.
- validateUpload() : void
- Validate uploaded file.
- validateUploads() : void
- Validate all uploaded files.
Properties
$message
public
string|null
$message
$messages
public
array<string|int, string>
$messages
= []
$status
public
string
$status
= 'success'
$blueprint
private
Blueprint
$blueprint
$data
private
ArrayAccess<string, mixed>|Data|null
$data
$directory
private
FlexDirectory
$directory
$enabled
private
bool
$enabled
= true
$files
private
array<string|int, UploadedFileInterface>
$files
= []
$flash
private
FormFlashInterface|null
$flash
$flashFolder
private
string
$flashFolder
$flexName
private
string
$flexName
$form
private
array<string|int, mixed>|null
$form
$id
private
string
$id
$name
private
string
$name
$sessionid
private
string
$sessionid
$submitted
private
bool
$submitted
$uniqueid
private
string
$uniqueid
Methods
__construct()
FlexForm constructor.
public
__construct(string $name, FlexDirectory $directory[, array<string|int, mixed>|null $options = null ]) : mixed
Parameters
- $name : string
- $directory : FlexDirectory
- $options : array<string|int, mixed>|null = null
__get()
public
__get(string $name) : mixed|null
Parameters
- $name : string
Attributes
- #[ReturnTypeWillChange]
Return values
mixed|null__isset()
public
__isset(string $name) : bool
Parameters
- $name : string
Attributes
- #[ReturnTypeWillChange]
Return values
bool__serialize()
public
final __serialize() : array<string|int, mixed>
Return values
array<string|int, mixed>__set()
public
__set(string $name, mixed $value) : void
Parameters
- $name : string
- $value : mixed
Attributes
- #[ReturnTypeWillChange]
__unserialize()
public
final __unserialize(array<string|int, mixed> $data) : void
Parameters
- $data : array<string|int, mixed>
__unset()
public
__unset(string $name) : void
Parameters
- $name : string
Attributes
- #[ReturnTypeWillChange]
disable()
public
disable() : void
enable()
public
enable() : void
get()
public
get(string $name[, mixed $default = null ][, string|null $separator = null ]) : mixed
Parameters
- $name : string
- $default : mixed = null
- $separator : string|null = null
getAction()
public
getAction() : string
Return values
stringgetAllFlashes()
Get all available form flash objects for this form.
public
getAllFlashes() : array<string|int, FormFlashInterface>
Return values
array<string|int, FormFlashInterface>getBlueprint()
Get blueprint used in the form.
public
getBlueprint() : Blueprint
Return values
BlueprintgetButtons()
public
getButtons() : array<string|int, mixed>
Return values
array<string|int, mixed>getData()
Get current data passed to the form.
public
getData() : Data|object
Return values
Data|objectgetDefaultValue()
public
getDefaultValue(string $name) : array<string|int, mixed>|mixed|null
Parameters
- $name : string
Return values
array<string|int, mixed>|mixed|nullgetDefaultValues()
public
getDefaultValues() : array<string|int, mixed>
Return values
array<string|int, mixed>getDirectory()
Get object associated to the form.
public
getDirectory() : FlexDirectory
Return values
FlexDirectorygetError()
public
getError() : string|null
Return values
string|nullgetErrors()
public
getErrors() : array<string|int, mixed>
Return values
array<string|int, mixed>getFields()
public
getFields() : array<string|int, mixed>
Return values
array<string|int, mixed>getFileDeleteAjaxRoute()
Get route for deleting files by AJAX.
public
getFileDeleteAjaxRoute([string|null $field = null ][, string|null $filename = null ]) : Route|null
Parameters
- $field : string|null = null
- $filename : string|null = null
Return values
Route|nullgetFiles()
public
getFiles() : array<string|int, mixed>|array<string|int, UploadedFileInterface>
Return values
array<string|int, mixed>|array<string|int, UploadedFileInterface>getFileUploadAjaxRoute()
Get route for uploading files by AJAX.
public
getFileUploadAjaxRoute() : Route|null
Return values
Route|nullgetFlash()
Get form flash object.
public
getFlash() : FormFlashInterface|FlexFormFlash
Return values
FormFlashInterface|FlexFormFlashgetFlexType()
public
getFlexType() : string
Return values
stringgetFormName()
public
getFormName() : string
Return values
stringgetId()
public
getId() : string
Return values
stringgetMediaTaskRoute()
Get media task route.
public
getMediaTaskRoute([array<string|int, mixed> $params = [] ][, string|null $extension = null ]) : string
Parameters
- $params : array<string|int, mixed> = []
- $extension : string|null = null
Return values
stringgetName()
public
getName() : string
Return values
stringgetNonce()
public
getNonce() : string
Return values
stringgetNonceAction()
public
getNonceAction() : string
Return values
stringgetNonceName()
public
getNonceName() : string
Return values
stringgetTask()
public
getTask() : string
Return values
stringgetTasks()
public
getTasks() : array<string|int, mixed>
Return values
array<string|int, mixed>getUniqueId()
public
getUniqueId() : string
Return values
stringgetValue()
Get a value from the form.
public
getValue(string $name) : mixed
Note: Used in form fields.
Parameters
- $name : string
handleRequest()
public
handleRequest(ServerRequestInterface $request) : FormInterface|$this
Parameters
- $request : ServerRequestInterface
Return values
FormInterface|$thisinitialize()
public
initialize() : $this
Return values
$thisinstance()
public
static instance([array<string|int, mixed> $options = [] ]) : FlexFormInterface
Parameters
- $options : array<string|int, mixed> = []
-
Options to initialize the form instance: (string) name: Form name, allows you to use custom form. (string) unique_id: Unique id for this form instance. (array) form: Custom form fields. (FlexDirectory) directory: Flex Directory, mandatory.
Return values
FlexFormInterfaceisEnabled()
public
isEnabled() : bool
Return values
boolisSubmitted()
public
isSubmitted() : bool
Return values
boolisValid()
public
isValid() : bool
Return values
booljsonSerialize()
public
jsonSerialize() : array<string|int, mixed>
Return values
array<string|int, mixed>render()
{@inheritdoc}
public
render([string $layout = null ][, array<string|int, mixed> $context = [] ]) : mixed
Parameters
- $layout : string = null
- $context : array<string|int, mixed> = []
Tags
reset()
public
reset() : void
set()
public
set(string $name, mixed $value[, string|null $separator = null ]) : $this
Parameters
- $name : string
- $value : mixed
- $separator : string|null = null
Return values
$thissetId()
public
setId(string $id) : void
Parameters
- $id : string
setRequest()
public
setRequest(ServerRequestInterface $request) : FormInterface|$this
Parameters
- $request : ServerRequestInterface
Return values
FormInterface|$thissetUniqueId()
Sets unique form id.
public
setUniqueId(string $uniqueId) : void
Parameters
- $uniqueId : string
submit()
public
submit(array<string|int, mixed> $data[, array<string|int, UploadedFileInterface>|null $files = null ]) : FormInterface|$this
Parameters
- $data : array<string|int, mixed>
- $files : array<string|int, UploadedFileInterface>|null = null
Return values
FormInterface|$thisvalidate()
public
validate() : bool
Return values
booldecodeData()
Decode POST data
protected
decodeData(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
- $data : array<string|int, mixed>
Return values
array<string|int, mixed>doSerialize()
protected
doSerialize() : array<string|int, mixed>
Return values
array<string|int, mixed>doSubmit()
protected
doSubmit(array<string|int, mixed> $data, array<string|int, mixed> $files) : void
Parameters
- $data : array<string|int, mixed>
- $files : array<string|int, mixed>
Tags
doUnserialize()
protected
doUnserialize(array<string|int, mixed> $data) : void
Parameters
- $data : array<string|int, mixed>
filterData()
Filter validated data.
protected
filterData([ArrayAccess|Data|null $data = null ]) : void
Parameters
- $data : ArrayAccess|Data|null = null
Tags
getFlashFolder()
protected
getFlashFolder() : string|null
Return values
string|nullgetFlashId()
protected
getFlashId() : string|null
Return values
string|nullgetFlashLookupFolder()
protected
getFlashLookupFolder() : string
Return values
stringgetSessionId()
protected
getSessionId() : string
Return values
stringgetTemplate()
protected
getTemplate(string $layout) : Template|TemplateWrapper
Parameters
- $layout : string
Tags
Return values
Template|TemplateWrappergetUnserializeAllowedClasses()
protected
getUnserializeAllowedClasses() : array<string|int, mixed>|bool
Return values
array<string|int, mixed>|booljsonDecode()
Recursively JSON decode POST data.
protected
jsonDecode(array<string|int, mixed> $data) : array<string|int, mixed>
Parameters
- $data : array<string|int, mixed>
Return values
array<string|int, mixed>parseRequest()
Parse PSR-7 ServerRequest into data and files.
protected
parseRequest(ServerRequestInterface $request) : array<string|int, mixed>
Parameters
- $request : ServerRequestInterface
Return values
array<string|int, mixed>setDirectory()
Note: this method clones the object.
protected
setDirectory(FlexDirectory $directory) : $this
Parameters
- $directory : FlexDirectory
Return values
$thissetError()
Set a single error.
protected
setError(string $error) : void
Parameters
- $error : string
setErrors()
Set all errors.
protected
setErrors(array<string|int, mixed> $errors) : void
Parameters
- $errors : array<string|int, mixed>
setFlashLookupFolder()
protected
setFlashLookupFolder(string $folder) : void
Parameters
- $folder : string
setName()
protected
setName(string $type, string $name) : void
Parameters
- $type : string
- $name : string
setSessionId()
protected
setSessionId(string $sessionId) : void
Parameters
- $sessionId : string
unsetFlash()
protected
unsetFlash() : void
validateData()
Validate data and throw validation exceptions if validation fails.
protected
validateData([ArrayAccess|Data|null $data = null ]) : void
Parameters
- $data : ArrayAccess|Data|null = null
Tags
validateUpload()
Validate uploaded file.
protected
validateUpload(UploadedFileInterface $file) : void
Parameters
- $file : UploadedFileInterface
validateUploads()
Validate all uploaded files.
protected
validateUploads(array<string|int, mixed> $files) : void
Parameters
- $files : array<string|int, mixed>