PageRenderTime 21ms CodeModel.GetById 13ms app.highlight 6ms RepoModel.GetById 1ms app.codeStats 0ms

/docs/languages/fr/modules/zend.validator.not-empty.rst

https://github.com/rixrix/zf2-documentation
ReStructuredText | 108 lines | 70 code | 38 blank | 0 comment | 0 complexity | aea2bdf8b897bbdbf50ee60971a34ff6 MD5 | raw file
  1.. EN-Revision: none
  2.. _zend.validator.set.notempty:
  3
  4NotEmpty
  5========
  6
  7Ce validateur permet de déterminer si une valeur est non vide. C'est utile lorsque vous travaillez avec des
  8formulaires ou des entrées utilisateur, là où vous pouvez l'utiliser pour savoir si des éléments requis ont
  9été saisis.
 10
 11.. _zend.validator.set.notempty.options:
 12
 13Options supportées par Zend\Validate\NotEmpty
 14---------------------------------------------
 15
 16Les options suivantes sont supportées par ``Zend\Validate\NotEmpty``\  :
 17
 18- **type**\  : paramètre le type de validation qui sera réalisée. Pour plus de détails, reportez vous à
 19  :ref:`cette section <zend.validator.set.notempty.types>`.
 20
 21.. _zend.validator.set.notempty.default:
 22
 23Comportement par défaut de Zend\Validate\NotEmpty
 24-------------------------------------------------
 25
 26Par défaut, ce validateur fonctionne différement de la fonction *PHP* ``empty()``. En particulier, ce validateur
 27va évaluer l'entier **0** et la chaine '**0**' comme vides.
 28
 29.. code-block:: php
 30   :linenos:
 31
 32   $valid = new Zend\Validate\NotEmpty();
 33   $value  = '';
 34   $result = $valid->isValid($value);
 35   // retourne false
 36
 37.. note::
 38
 39   **Le comportement par défaut diffère de PHP**
 40
 41   Sans configuration ajoutée, ``Zend\Validate\NotEmpty`` diffère de *PHP*.
 42
 43.. _zend.validator.set.notempty.types:
 44
 45Changer le comportement de Zend\Validate\NotEmpty
 46-------------------------------------------------
 47
 48Certains projets ont des opinions différentes sur ce qui peut être considéré comme 'vide'. Une chaine seulement
 49composée d'espaces blancs pourrait être considérée comme vide, ou **0** pourrait être considéré comme
 50non-vide (surtout dans les séquences logiques booléennes). Pour correspondre aux différents besoins,
 51``Zend\Validate\NotEmpty`` vous permet de configurer les types que vous considérez comme vides.
 52
 53Les types suivants sont gérés :
 54
 55- **booléen**\  : Retourne ``FALSE`` lorsque la valeur booléenne est ``FALSE``.
 56
 57- **entier**\  : Retourne ``FALSE`` lorsque l'entier **0** est passé. Par défaut cette validation n'est pas
 58  activée et retourne ``TRUE`` pour toute valeur d'entier.
 59
 60- **flottant**\  : Retourne ``FALSE`` lorsque le flottant **0.0** est passé. Par défaut cette validation n'est
 61  pas activée et retourne ``TRUE`` pour toute valeur de flottant.
 62
 63- **chaine**\  : Retourne ``FALSE`` lorsque la chaine vide **''** est passée.
 64
 65- **zero**\  : Retourne ``FALSE`` lorsque le seul caractère zéro (**'0'**) est passé.
 66
 67- **tableau_vide**\  : Retourne ``FALSE`` lorsqu'un tableau vide **array()** est passé.
 68
 69- **null**\  : Retourne ``FALSE`` lorsqu'une valeur ``NULL`` est passée.
 70
 71- **php**\  : Retourne ``FALSE`` lorsque la fonction *PHP* ``empty()`` retournerait ``TRUE``.
 72
 73- **espace**\  : Retourne ``FALSE`` lorsqu'une chaine ne contenant que des caractères espace est passée.
 74
 75- **tout**\  : Retourne ``FALSE`` pour tous les types gérés cités ci-dessus.
 76
 77Toute autre valeur passée retourne ``TRUE`` par défaut.
 78
 79Il existe différentes manières de selectionner les types ci-dessus. Vous pouvez en spécifier un ou plusieurs,
 80sous forme de tableau ou de constantes ou encore de chaines. Voyez les exemples ci-après :
 81
 82.. code-block:: php
 83   :linenos:
 84
 85   // Retourne false pour 0
 86   $validator = new Zend\Validate\NotEmpty(Zend\Validate\NotEmpty::INTEGER);
 87
 88   // Retourne false pour 0 ou '0'
 89   $validator = new Zend\Validate\NotEmpty(
 90       Zend\Validate\NotEmpty::INTEGER + Zend\NotEmpty\NotEmpty::ZERO
 91   );
 92
 93   // Retourne false pour 0 ou '0'
 94   $validator = new Zend\Validate\NotEmpty(array(
 95       Zend\Validate\NotEmpty::INTEGER,
 96       Zend\Validate\NotEmpty::ZERO
 97   ));
 98
 99   // Retourne false pour 0 ou '0'
100   $validator = new Zend\Validate\NotEmpty(array(
101       'integer',
102       'zero',
103   ));
104
105Il est aussi possible de passer un objet ``Zend_Config`` afin de préciser les types à utiliser. Après
106instantiation, ``setType()`` peut être utilisée.
107
108