class Form extends Container implements HtmlStringable

Creates, validates and renders HTML forms.

Constants

EQUAL

validator

IS_IN

validator

NOT_EQUAL

validator

IS_NOT_IN

validator

FILLED

validator

BLANK

validator

REQUIRED

validator

VALID

validator

SUBMITTED

validator

MIN_LENGTH

validator

MAX_LENGTH

validator

LENGTH

validator

EMAIL

validator

URL

validator

PATTERN

validator

PATTERN_ICASE

validator

INTEGER

validator

NUMERIC

validator

FLOAT

validator

MIN

validator

MAX

validator

RANGE

validator

COUNT

validator

MAX_FILE_SIZE

validator

MIME_TYPE

validator

IMAGE

validator

MAX_POST_SIZE

validator

GET

method

POST

method

DATA_TEXT

submitted data types

DATA_LINE

submitted data types

DATA_FILE

submitted data types

DATA_KEYS

submitted data types

TRACKER_ID

PROTECTOR_ID

Properties

array $onSuccess Occurs when the form is submitted and successfully validated
array $onError
array $onSubmit
array $onRender
$httpRequest
protected bool $crossOrigin
string $action
string $method

Methods

__construct(string $name = null)

Form constructor.

Form|null
getForm(bool $throw = true)

Returns self.

setAction(string|object $url)

Sets form's action.

mixed
getAction()

Returns form's action.

setMethod(string $method)

Sets form's method GET or POST.

string
getMethod()

Returns form's method.

bool
isMethod(string $method)

Checks if the request method is the given one.

setHtmlAttribute(string $name, $value = true)

Changes forms's HTML attribute.

void
allowCrossOrigin()

Disables CSRF protection using a SameSite cookie.

addProtection(string $errorMessage = null)

Cross-Site Request Forgery (CSRF) form protection.

addGroup(string $caption = null, bool $setAsCurrent = true)

Adds fieldset group to the form.

void
removeGroup(string|ControlGroup $name)

Removes fieldset group from form.

array
getGroups()

Returns all defined groups.

ControlGroup|null
getGroup(string|int $name)

Returns the specified group.

setTranslator(Translator|null $translator)

Sets translate adapter.

Translator|null
getTranslator()

Returns translate adapter.

bool
isAnchored()

Tells if the form is anchored.

isSubmitted()

Tells if the form was submitted.

bool
isSuccess()

Tells if the form was submitted and successfully validated.

setSubmittedBy(SubmitterControl|null $by)

Sets the submittor control.

mixed
getHttpData(int $type = null, string $htmlName = null)

Returns submitted HTTP data.

void
fireEvents()

Fires submit/click events.

reset()

Resets form.

array|null
receiveHttpData()

Internal: returns submitted HTTP data or null when form was not submitted.

void
validate(array $controls = null)

Performs the server side validation.

void
validateMaxPostSize()

No description

void
addError($message, bool $translate = true)

Adds global error message.

array
getErrors()

Returns global validation errors.

bool
hasErrors()

No description

void
cleanErrors()

No description

array
getOwnErrors()

Returns form's validation errors.

Html
getElementPrototype()

Returns form's HTML element template.

setRenderer(FormRenderer|null $renderer)

Sets form renderer.

getRenderer()

Returns form renderer.

beforeRender()

No description

void
fireRenderEvents()

Must be called before form is rendered and render() is not used.

void
render(...$args)

Renders form.

string
__toString()

Renders form to string.

array
getToggles()

No description

static void
initialize(bool $reinit = false)

Initialize standalone forms.

setHttpRequest(IRequest $request)

No description

Details

at line 137
__construct(string $name = null)

Form constructor.

Parameters

string $name

at line 156
Form|null getForm(bool $throw = true)

Returns self.

Parameters

bool $throw

Return Value

Form|null

at line 167
Form setAction(string|object $url)

Sets form's action.

Parameters

string|object $url

Return Value

Form

at line 178
mixed getAction()

Returns form's action.

Return Value

mixed

at line 188
Form setMethod(string $method)

Sets form's method GET or POST.

Parameters

string $method

Return Value

Form

at line 201
string getMethod()

Returns form's method.

Return Value

string

at line 210
bool isMethod(string $method)

Checks if the request method is the given one.

Parameters

string $method

Return Value

bool

at line 220
Form setHtmlAttribute(string $name, $value = true)

Changes forms's HTML attribute.

Parameters

string $name
$value

Return Value

Form

at line 230
void allowCrossOrigin()

Disables CSRF protection using a SameSite cookie.

Return Value

void

at line 239
CsrfProtection addProtection(string $errorMessage = null)

Cross-Site Request Forgery (CSRF) form protection.

Parameters

string $errorMessage

Return Value

CsrfProtection

at line 250
ControlGroup addGroup(string $caption = null, bool $setAsCurrent = true)

Adds fieldset group to the form.

Parameters

string $caption
bool $setAsCurrent

Return Value

ControlGroup

at line 270
void removeGroup(string|ControlGroup $name)

Removes fieldset group from form.

Parameters

string|ControlGroup $name

Return Value

void

at line 295
array getGroups()

Returns all defined groups.

Return Value

array

at line 305
ControlGroup|null getGroup(string|int $name)

Returns the specified group.

Parameters

string|int $name

Return Value

ControlGroup|null

at line 318
Form setTranslator(Translator|null $translator)

Sets translate adapter.

Parameters

Translator|null $translator

Return Value

Form

at line 328
Translator|null getTranslator()

Returns translate adapter.

Return Value

Translator|null

at line 340
bool isAnchored()

Tells if the form is anchored.

Return Value

bool

at line 350
SubmitterControl|bool isSubmitted()

Tells if the form was submitted.

Return Value

SubmitterControl|bool submittor control

at line 362
bool isSuccess()

Tells if the form was submitted and successfully validated.

Return Value

bool

at line 373
Form setSubmittedBy(SubmitterControl|null $by)

Sets the submittor control.

Parameters

SubmitterControl|null $by

Return Value

Form

at line 384
mixed getHttpData(int $type = null, string $htmlName = null)

Returns submitted HTTP data.

Parameters

int $type
string $htmlName

Return Value

mixed

at line 404
void fireEvents()

Fires submit/click events.

Return Value

void

at line 461
Form reset()

Resets form.

Return Value

Form

at line 472
protected array|null receiveHttpData()

Internal: returns submitted HTTP data or null when form was not submitted.

Return Value

array|null

at line 504
void validate(array $controls = null)

Performs the server side validation.

Parameters

array $controls

Return Value

void

at line 516
void validateMaxPostSize()

Return Value

void

at line 532
void addError($message, bool $translate = true)

Adds global error message.

Parameters

$message
bool $translate

Return Value

void

at line 544
array getErrors()

Returns global validation errors.

Return Value

array

at line 550
bool hasErrors()

Return Value

bool

at line 556
void cleanErrors()

Return Value

void

at line 565
array getOwnErrors()

Returns form's validation errors.

Return Value

array

at line 577
Html getElementPrototype()

Returns form's HTML element template.

Return Value

Html

at line 592
Form setRenderer(FormRenderer|null $renderer)

Sets form renderer.

Parameters

FormRenderer|null $renderer

Return Value

Form

at line 602
FormRenderer getRenderer()

Returns form renderer.

Return Value

FormRenderer

at line 611
protected beforeRender()

at line 619
void fireRenderEvents()

Must be called before form is rendered and render() is not used.

Return Value

void

at line 632
void render(...$args)

Renders form.

Parameters

...$args

Return Value

void

at line 643
string __toString()

Renders form to string.

Return Value

string

at line 659
array getToggles()

Return Value

array

at line 675
static void initialize(bool $reinit = false)

Initialize standalone forms.

Parameters

bool $reinit

Return Value

void

at line 699
setHttpRequest(IRequest $request)

Parameters

IRequest $request