Symfony2 validation

Transcript

1. Production agency specializing in Web Development www.void.fr PHP framework www.symfony.com

2. http://twitter.com/baazzi http://www.facebook.com/jBinfo http://plus.google.com/113667438028898816639 Lhassan Baazzi Web Developper #php #Symfony2 at

   VOID
3. None

4. $1- Why ? $2- Goal $3- How ? $4- What

   is a constraint ? $5- Basic validation example $6- Supported constraints $7- The validator service $8- Validation and Forms $9- Translation constraint messages $10- Constraint targets $11- Validation groups $12- Validating values $13- How to create a custom validation constraint ? Summary $0

5. Don't Trust User Input Why ? $1

6. 1. Validation is a very common task in web applications.

   2. Data entered in forms needs to be validated. 3. Data also needs to be validated before it is written into a database or passed to a web service. Why ? $1

7. The goal of validation is to tell you whether or

   not the data of an object is valid. Goal $2

8. configure a list of rules (called constraints) that the object

   must follow in order to be valid. How ? $3 These constraints can be specified via a number of different formats (YAML, XML, annotations, or PHP).

9. a constraint is simply a PHP object that makes an

   assertive statement. Constraint $4

10. Basic validation example $5 For example, to guarantee that the

    $name property is not empty:

11. Basic validation example $5 Imports constraints namespace Add NotBlank constraint

    For example, to guarantee that the $name property is not empty:

12. Basic validation example $5 The Symfony2 validator is enabled by

    default, but you must explicitly enable annotations if you're using the annotation method to specify your constraints:

13. Basic Constraints  NotBlank  Blank  NotNull  Null

     True  False  Type String Constraints  Email  MinLength  MaxLength  Url  Regex  Ip Date Constraints  Date  DateTime  Time Collection Constraints  Choice  Collection  UniqueEntity  Language  Locale  Country Number Constraints  Max  Min File Constraints  File  Image Other Constraints  Callback  All  Valid Supported constraints $6

14. Basic Constraints  NotBlank  Blank  NotNull  Null

     True  False  Type String Constraints  Email  MinLength  MaxLength  Url  Regex  Ip Date Constraints  Date  DateTime  Time Collection Constraints  Choice  Collection  UniqueEntity  Language  Locale  Country Number Constraints  Max  Min File Constraints  File  Image Other Constraints  Callback  All  Valid Supported constraints $6

15. The validator service $7 To validate an object, use the

    validate method on the validator service.

16. The validator service $7 Is to read the constraints (i.e.

    rules) of a class and verify whether or not the data on the object satisfies those constraints. The job of the validator: If validation fails, an array of errors is returned.

17. The validator service $7

18. The validator service $7 Each validation error (called a constraint

    violation), is represented by a ConstraintViolation object. ConstraintViolation: http://api.symfony.com/2.0/Symfony/Component/Validator/ConstraintViolation.html

19. Validation and Forms $8 Symfony's form library uses the validator

    service internally to validate the underlying object after values have been submitted and bound.

20. Validation and Forms $8 The constraint violations on the object

    are converted into FieldError objects that can easily be displayed with your form.

21. Validation and Forms $8

22. Translating constraint messages $9 Create a translation file under the

    validators catalog for the constraint messages, typically in the Resources/translations/ directory of the bundle.

23. Translating constraint messages $9 Constraint message Constraint message Constraint message

    Constraint message Translation message Translation message

24. Constraint targets $10 Constraints can be applied to a class

    property (e.g. name) or a public getter method (e.g. getFullName)

25. Constraint targets $10 Properties: The validator service allows you to

    validate private, protected or public properties. The example below shows you how to configure the $firstName property of an Author class to have at least 3 characters:

26. Constraint targets $10 Getters: Constraints can also be applied to

    the return value of a method. Validator service allows you to add a constraint to any public method whose name starts with “get” or “is”. In this guide, both of these types of methods are referred to as “getters”.

27. Constraint targets $10 Getters:

28. Constraint targets $10 Some constraints apply to the entire class

    being validated. For example, the Callback constraint is a generic constraint that's applied to the class itself. When that class is validated, methods specified by that constraint are simply executed so that each can provide more custom validation.

29. Validation groups $11 How to validate an object against only

    some of the constraints on that class ? Question:

30. Validation groups $11 Organize each constraint into one or more

    “validation groups”, and then apply validation against just one or more group of constraints. Answer:

31. Validation groups $11 Suppose you have a User class, which

    is used both when a user registers and when a user updates his/her contact information later: Example:

32. Validation groups $11

33. Validation groups $11 With this configuration, there are two validation

    groups:  default: contains the constraints not assigned to any other group;  registration: contains the constraints on the email and password fields only.

34. Validation groups $11 To tell the validator to use a

    specific group, pass one or more group names as the second argument to the validate() method:

35. Validation groups $11 validation groups in forms: Controller: Form Class:

36. Validating values $12 you've seen how you can validate entire

    objects. But sometimes, you just want to validate a simple value - like to verify that a string is a valid email address.

37. verify that a string is a valid email address: Validating

    values $12 Import constraint Email Import constraint Email Create the consraint Create the consraint Assigned the error message Assigned the error message Execute Execute Check for errors Check for errors

38. How to create a custom validation constraint ? $13 http://symfony.com/doc/current/cookbook/

    validation/custom_constraint.html

39. Questions ?