Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Update validation.rst#4789

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Closed
ifdattic wants to merge3 commits intosymfony:2.3fromifdattic:patch-10
Closed
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
123 changes: 83 additions & 40 deletionsbook/validation.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -35,7 +35,7 @@ application. The goal of validation is to tell you if the data
of an object is valid. For this to work, you'll configure a list of rules
(called :ref:`constraints <validation-constraints>`) that the object must
follow in order to be valid. These rules can be specified via a number of
different formats (YAML, XML, annotations, or PHP).
different formats (annotations, YAML, XML or PHP).

For example, to guarantee that the ``$name`` property is not empty, add the
following:
Expand DownExpand Up@@ -71,7 +71,8 @@ following:
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\Author">
<property name="name">
Expand DownExpand Up@@ -271,8 +272,10 @@ annotations if you're using the annotation method to specify your constraints:
<container xmlns="http://symfony.com/schema/dic/services"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:framework="http://symfony.com/schema/dic/symfony"
xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/services
http://symfony.com/schema/dic/services/services-1.0.xsd
http://symfony.com/schema/dic/symfony
http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

<framework:config>
<framework:validation enable-annotations="true" />
Expand DownExpand Up@@ -338,7 +341,9 @@ constraint, have several configuration options available. Suppose that the
Acme\BlogBundle\Entity\Author:
properties:
gender:
- Choice: { choices: [male, female], message: Choose a valid gender. }
- Choice:
choices: [male, female]
message: Choose a valid gender.

.. code-block:: php-annotations

Expand All@@ -362,7 +367,8 @@ constraint, have several configuration options available. Suppose that the
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\Author">
<property name="gender">
Expand DownExpand Up@@ -391,10 +397,13 @@ constraint, have several configuration options available. Suppose that the

public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('gender', new Choice(array(
'choices' => array('male', 'female'),
'message' => 'Choose a valid gender.',
)));
$metadata->addPropertyConstraint(
'gender',
new Choice(array(
'choices' => array('male', 'female'),
'message' => 'Choose a valid gender.',
))
);
}
}

Expand DownExpand Up@@ -436,7 +445,8 @@ options can be specified in this way.
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\Author">
<property name="gender">
Expand DownExpand Up@@ -476,7 +486,9 @@ If you're ever unsure of how to specify an option, either check the API document
for the constraint or play it safe by always passing in an array of options
(the first method shown above).

Translation Constraint Messages
.. _translation-constraint-messages:

Translating Constraint Messages
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

You need to add the former label to be BC:

.. _translation-constraint-messages:Translating Constraint Messages-------------------------------

Copy link
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Thanks, will change it now

-------------------------------

For information on translating the constraint messages, see
Expand DownExpand Up@@ -541,7 +553,8 @@ class to have at least 3 characters.
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\Author">
<property name="firstName">
Expand All@@ -568,7 +581,10 @@ class to have at least 3 characters.

public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('firstName', new NotBlank());
$metadata->addPropertyConstraint(
'firstName',
new NotBlank()
);
$metadata->addPropertyConstraint(
'firstName',
new Length(array("min" => 3)));
Expand DownExpand Up@@ -626,7 +642,8 @@ this method must return ``true``:
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\Author">
<getter property="passwordLegal">
Expand All@@ -649,9 +666,12 @@ this method must return ``true``:
{
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addGetterConstraint('passwordLegal', new True(array(
'message' => 'The password cannot match your first name',
)));
$metadata->addGetterConstraint(
'passwordLegal',
new True(array(
'message' => 'The password cannot match your first name',
))
);
}
}

Expand DownExpand Up@@ -744,7 +764,8 @@ user registers and when a user updates their contact information later:
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\User">
<property name="email">
Expand All@@ -769,7 +790,7 @@ user registers and when a user updates their contact information later:
</property>
<property name="city">
<constraint name="Length">
<option name="min">7</option>
<option name="min">2</option>
</constraint>
</property>
</class>
Expand All@@ -789,21 +810,33 @@ user registers and when a user updates their contact information later:
{
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('email', new Email(array(
'groups' => array('registration'),
)));

$metadata->addPropertyConstraint('password', new NotBlank(array(
'groups' => array('registration'),
)));
$metadata->addPropertyConstraint('password', new Length(array(
'min' => 7,
'groups' => array('registration')
)));
$metadata->addPropertyConstraint(
'email',
new Email(array(
'groups' => array('registration'),
))
);

$metadata->addPropertyConstraint(
'password',
new NotBlank(array(
'groups' => array('registration'),
))
);
$metadata->addPropertyConstraint(
'password',
new Length(array(
'min' => 7,
'groups' => array('registration'),
))
);

$metadata->addPropertyConstraint(
'city',
Length(array("min" => 3)));
new Length(array(
'min' => 2,
))
);
}
}

Expand DownExpand Up@@ -919,7 +952,10 @@ username and the password are different only if all other validation passes
private $password;

/**
* @Assert\True(message="The password cannot match your username", groups={"Strict"})
* @Assert\True(
* message="The password cannot match your username",
* groups={"Strict"}
* )
*/
public function isPasswordLegal()
{
Expand All@@ -933,7 +969,8 @@ username and the password are different only if all other validation passes
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\BlogBundle\Entity\User">
<property name="username">
Expand DownExpand Up@@ -962,10 +999,11 @@ username and the password are different only if all other validation passes
// src/Acme/BlogBundle/Entity/User.php
namespace Acme\BlogBundle\Entity;

use Symfony\Component\Security\Core\User\UserInterface;
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints as Assert;

class User
class User implements UserInterface
{
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
Expand DownExpand Up@@ -1062,7 +1100,8 @@ entity and a new constraint group called ``Premium``:
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

<class name="Acme\DemoBundle\Entity\User">
<property name="name">
Expand DownExpand Up@@ -1100,10 +1139,13 @@ entity and a new constraint group called ``Premium``:
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('name', new Assert\NotBlank());
$metadata->addPropertyConstraint('creditCard', new Assert\CardScheme(
'schemes' => array('VISA'),
'groups' => array('Premium'),
));
$metadata->addPropertyConstraint(
'creditCard',
new Assert\CardScheme(array(
'schemes' => array('VISA'),
'groups' => array('Premium'),
))
);
}
}

Expand DownExpand Up@@ -1206,6 +1248,7 @@ email address. This is actually pretty easy to do. From inside a controller,
it looks like this::

use Symfony\Component\Validator\Constraints\Email;

// ...

public function addEmailAction($email)
Expand Down
[8]ページ先頭
©2009-2025 Movatter.jp