Class ArrayContext

Provides a basic array based context provider for FormHelper.

This adapter is useful in testing or when you have forms backed by simple array data structures.

Important keys:

  • data Holds the current values supplied for the fields.
  • defaults The default values for fields. These values will be used when there is no data set. Data should be nested following the dot separated paths you access your fields with.
  • required A nested array of fields, relationships and boolean flags to indicate a field is required. The value can also be a string to be used as the required error message
  • schema An array of data that emulate the column structures that Cake\Database\Schema\Schema uses. This array allows you to control the inferred type for fields and allows auto generation of attributes like maxlength, step and other HTML attributes. If you want primary key/id detection to work. Make sure you have provided a _constraints array that contains primary. See below for an example.
  • errors An array of validation errors. Errors should be nested following the dot separated paths you access your fields with.

    Example

    $article = [
    'data' => [
     'id' => '1',
     'title' => 'First post!',
    ],
    'schema' => [
     'id' => ['type' => 'integer'],
     'title' => ['type' => 'string', 'length' => 255],
     '_constraints' => [
       'primary' => ['type' => 'primary', 'columns' => ['id']]
     ]
    ],
    'defaults' => [
     'title' => 'Default title',
    ],
    'required' => [
     'id' => true, // will use default required message
     'title' => 'Please enter a title',
     'body' => false,
    ],
    ];
Namespace: Cake\View\Form

Properties summary

  • $_context protected
    array

    Context data for this object.

Method Summary

  • __construct() public

    Constructor.

  • attributes() public

    Get an associative array of other attributes for a field name.

  • error() public

    Get the errors for a given field

  • fieldNames() public

    Get the field names of the top level object in this context.

  • getMaxLength() public

    Get field length from validation

  • getPrimaryKey() public

    Get the fields used in the context as a primary key.

  • getRequiredMessage() public

    Gets the default "required" error message for a field

  • hasError() public

    Check whether or not a field has an error attached to it

  • isCreate() public

    Returns whether or not this form is for a create operation.

  • isPrimaryKey() public

    Returns true if the passed field name is part of the primary key for this context

  • isRequired() public

    Check if a given field is 'required'.

  • primaryKey() public

    Get the fields used in the context as a primary key.

  • stripNesting() protected

    Strips out any numeric nesting

  • type() public

    Get the abstract field type for a given field name.

  • val() public

    Get the current value for a given field.

Method Detail

__construct() public

__construct(array $context)

Constructor.

Parameters

array $context

Context info.

attributes() public

attributes(string $field)

Get an associative array of other attributes for a field name.

Parameters

string $field

A dot separated path to get additional data on.

Returns

array

An array of data describing the additional attributes on a field.

error() public

error(string $field)

Get the errors for a given field

Parameters

string $field

A dot separated path to check errors on.

Returns

array

An array of errors, an empty array will be returned when the context has no errors.

fieldNames() public

fieldNames()

Get the field names of the top level object in this context.

Returns

string[]

A list of the field names in the context.

getMaxLength() public

getMaxLength(string $field)

Get field length from validation

In this context class, this is simply defined by the 'length' array.

Parameters

string $field

A dot separated path to check required-ness for.

Returns

int|null

getPrimaryKey() public

getPrimaryKey()

Get the fields used in the context as a primary key.

Returns

string[]

getRequiredMessage() public

getRequiredMessage(string $field)

Gets the default "required" error message for a field

Parameters

string $field

A dot separated path to the field name

Returns

string|null

hasError() public

hasError(string $field)

Check whether or not a field has an error attached to it

Parameters

string $field

A dot separated path to check errors on.

Returns

bool

Returns true if the errors for the field are not empty.

isCreate() public

isCreate()

Returns whether or not this form is for a create operation.

For this method to return true, both the primary key constraint must be defined in the 'schema' data, and the 'defaults' data must contain a value for all fields in the key.

Returns

bool

isPrimaryKey() public

isPrimaryKey(string $field)

Returns true if the passed field name is part of the primary key for this context

Parameters

string $field

A dot separated path to the field a value is needed for.

Returns

bool

isRequired() public

isRequired(string $field)

Check if a given field is 'required'.

In this context class, this is simply defined by the 'required' array.

Parameters

string $field

A dot separated path to check required-ness for.

Returns

bool|null

primaryKey() public

primaryKey()

Get the fields used in the context as a primary key.

Returns

string[]

stripNesting() protected

stripNesting(string $field)

Strips out any numeric nesting

For example users.0.age will output as users.age

Parameters

string $field

A dot separated path

Returns

string

A string with stripped numeric nesting

type() public

type(string $field)

Get the abstract field type for a given field name.

Parameters

string $field

A dot separated path to get a schema type for.

Returns

string|null

An abstract data type or null.

See Also

\Cake\Database\TypeFactory

val() public

val(string $field, array $options)

Get the current value for a given field.

This method will coalesce the current data and the 'defaults' array.

Parameters

string $field

A dot separated path to the field a value is needed for.

array $options optional

Options:

  • default: Default value to return if no value found in data or context record.
  • schemaDefault: Boolean indicating whether default value from context's schema should be used if it's not explicitly provided.

Returns

mixed

Property Detail

$_context protected

Context data for this object.

Type

array

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.1/class-Cake.View.Form.ArrayContext.html