You are browsing the documentation for Symfony 2.5 which is not maintained anymore.
Consider upgrading your projects to Symfony 5.2.
Issn
Issn¶
New in version 2.3: The Issn constraint was introduced in Symfony 2.3.
Validates that a value is a valid International Standard Serial Number (ISSN).
Applies to | property or method |
Options | |
Class | Symfony\Component\Validator\Constraints\Issn |
Validator | Symfony\Component\Validator\Constraints\IssnValidator |
Basic Usage¶
- YAML
1 2 3 4 5
# src/Acme/JournalBundle/Resources/config/validation.yml Acme\JournalBundle\Entity\Journal: properties: issn: - Issn: ~
- Annotations
1 2 3 4 5 6 7 8 9 10 11 12
// src/Acme/JournalBundle/Entity/Journal.php namespace Acme\JournalBundle\Entity; use Symfony\Component\Validator\Constraints as Assert; class Journal { /** * @Assert\Issn */ protected $issn; }
- XML
1 2 3 4 5 6 7 8 9 10 11 12
<!-- src/Acme/JournalBundle/Resources/config/validation.xml --> <?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"> <class name="Acme\JournalBundle\Entity\Journal"> <property name="issn"> <constraint name="Issn" /> </property> </class> </constraint-mapping>
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13
// src/Acme/JournalBundle/Entity/Journal.php namespace Acme\JournalBundle\Entity; use Symfony\Component\Validator\Mapping\ClassMetadata; use Symfony\Component\Validator\Constraints as Assert; class Journal { public static function loadValidatorMetadata(ClassMetadata $metadata) { $metadata->addPropertyConstraint('issn', new Assert\Issn()); } }
Options¶
message¶
type: String
default: This value is not a valid ISSN.
The message shown if the given value is not a valid ISSN.
caseSensitive¶
type: Boolean
default: false
The validator will allow ISSN values to end with a lower case ‘x’ by default.
When switching this to true
, the validator requires an upper case ‘X’.
requireHyphen¶
type: Boolean
default: false
The validator will allow non hyphenated ISSN values by default. When switching
this to true
, the validator requires a hyphenated ISSN value.
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.