1. class
  2. Symfony
  3. Component
  4. Validator
  5. Constraints
  6. Optional

Optional

class Optional extends Existence

Constants

DEFAULT_GROUP

The name of the group given to all constraints with no explicit group
CLASS_CONSTRAINT

Marks a constraint that can be put onto classes
PROPERTY_CONSTRAINT

Marks a constraint that can be put onto properties

Properties

mixed $payload Domain-specific data attached to a constraint from Constraint
array $groups The groups that the constraint belongs to from Constraint
$constraints from Existence

Methods

static string
getErrorName(int $errorCode)

Returns the name of the given error code.

from Constraint
__construct(mixed $options = null)

Initializes the constraint with options.

from Composite
__set(string $option, mixed $value)

Sets the value of a lazily initialized option.

from Constraint
mixed
__get(string $option)

Returns the value of a lazily initialized option.

from Constraint
addImplicitGroupName(string $group)

Adds the given group if this constraint is in the Default group

from Composite
string
getDefaultOption()

Returns the name of the default option

from Existence
array
getRequiredOptions()

Returns the name of the required options

from Constraint
string
validatedBy()

Returns the name of the class that validates this constraint

from Constraint
string|array
getTargets()

Returns whether the constraint can be put onto classes, properties or both

from Constraint
array
__sleep()

Optimizes the serialized value to minimize storage space.

from Constraint

Details

in Constraint at line line 75
static string getErrorName(int $errorCode)

Returns the name of the given error code.

Parameters

int $errorCode The error code

Return Value

string The name of the error code

Exceptions

InvalidArgumentException If the error code does not exist

in Composite at line line 55
__construct(mixed $options = null)

Initializes the constraint with options.

You should pass an associative array. The keys should be the names of existing properties in this class. The values should be the value for these properties.

Alternatively you can override the method getDefaultOption() to return the name of an existing property. If no associative array is passed, this property is set instead.

You can force that certain options are set by overriding getRequiredOptions() to return the names of these options. If any option is not set here, an exception is thrown.

Parameters

mixed $options The options (as associative array) or the value for the default option (any other type)

Exceptions

InvalidOptionsException When you pass the names of non-existing options
MissingOptionsException When you don't pass any of the options returned by getRequiredOptions()
ConstraintDefinitionException When you don't pass an associative array, but getDefaultOption() returns null

in Constraint at line line 184
__set(string $option, mixed $value)

Sets the value of a lazily initialized option.

Corresponding properties are added to the object on first access. Hence this method will be called at most once per constraint instance and option name.

Parameters

string $option The option name
mixed $value The value to set

Exceptions

InvalidOptionsException If an invalid option name is given

in Constraint at line line 212
mixed __get(string $option)

Returns the value of a lazily initialized option.

Corresponding properties are added to the object on first access. Hence this method will be called at most once per constraint instance and option name.

Parameters

string $option The option name

Return Value

mixed The value of the option

Exceptions

InvalidOptionsException If an invalid option name is given

in Composite at line line 122
addImplicitGroupName(string $group)

Adds the given group if this constraint is in the Default group

Parameters

string $group

in Existence at line line 21
string getDefaultOption()

Returns the name of the default option

Override this method to define a default option.

Return Value

string

in Constraint at line line 261
array getRequiredOptions()

Returns the name of the required options

Override this method if you want to define required options.

Return Value

array

See also

__construct()

in Constraint at line line 277
string validatedBy()

Returns the name of the class that validates this constraint

By default, this is the fully qualified name of the constraint class suffixed with "Validator". You can override this method to change that behaviour.

Return Value

string

in Constraint at line line 293
string|array getTargets()

Returns whether the constraint can be put onto classes, properties or both

This method should return one or more of the constants Constraint::CLASSCONSTRAINT and Constraint::PROPERTYCONSTRAINT.

Return Value

string|array One or more constant values

in Constraint at line line 309
array __sleep()

Optimizes the serialized value to minimize storage space.

Return Value

array The properties to serialize