Symfony2 API
Class

Symfony\Component\Validator\Constraints\Ip

class Ip extends Constraint

Validates that a value is a valid IP address.

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.

V4

V6

ALL

V4_NO_PRIV

V6_NO_PRIV

ALL_NO_PRIV

V4_NO_RES

V6_NO_RES

ALL_NO_RES

V4_ONLY_PUBLIC

V6_ONLY_PUBLIC

ALL_ONLY_PUBLIC

Properties

mixed $payload Domain-specific data attached to a constraint
array $groups array$groupsThe groups that the constraint belongs to
$version
$message

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.

__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 Constraint
string getDefaultOption()

Returns the name of the default option.

from Constraint
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 78
static public 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

at line 74
public __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 187
public __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 215
public 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 Constraint at line 233
public addImplicitGroupName(string $group)

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

Parameters

string $group

in Constraint at line 251
public string getDefaultOption()

Returns the name of the default option.

Override this method to define a default option.

Return Value

string

See also

__construct()

in Constraint at line 266
public 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 282
public 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 298
public 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 314
public array __sleep()

Optimizes the serialized value to minimize storage space.

Return Value

array The properties to serialize