Le Carnet Tech de Michaël

Aller au contenu | Aller au menu | Aller à la recherche

vendredi 15 mai 2009

sfValidatorEmails

La classe suivante permet de valider, dans symfony, une liste d’emails, entrée par l’utilisateur dans un champs de type textarea. Elle s’appuie sur le travail de la classe sfValidatorEmail.

class sfValidatorEmails extends sfValidatorBase
{

  public function __construct($options = array(), $messages = array()) 
  {
    parent::__construct(array_merge($options, array('trim' => true)), $messages);
  }

  public function doClean($value) 
  {
    $i = 0;
    $emails = explode("
", $value);
    $validator = new sfValidatorEmail($this->options, $this->messages);
    
    $cleaned_emails = array();

    try {
      foreach ($emails as $email) {
        ++$i;
        $cleaned_emails[] = $validator->clean($email);
      }
    } catch (Exception $e) {
        throw new sfValidatorError($this, 'invalid',
                                   array('line' => $i, 'bad_email' => $email));
    }
    return implode("
",$cleaned_emails);
  }

}

mercredi 10 décembre 2008

Validateurs dynamiques

Il est courant qu’un formulaire web nécessite des validateurs dynamiques, c’est à dire dépendant de certaines valeurs du formulaire lui même. Dans une des applications que j’ai écrite récemment une case à côcher permet à l’utilisateur de tester le formulaire et de ne pas enclencher l’action normale. Ainsi lorsque cette case à côcher est validée, un champs du formulaires n’est plus obligatoire, et un autre le devient.

Pour résoudre ce problème, une des solutions connue consiste à surcharger la méthode bind de la classe du formulaire, dérivée de sfForm, et de changer à la volée les validateurs.

Pour ma part je préfère exécuter ce changement dynamique de validateur dans le preValidator. Voici ce que cela donne:

 public function configure()
 {
   [...]
   $this->validatorSchema->setPreValidator(
     new sfValidatorCallback (
       array('callback' => array($this, 'isTest'))));
 }
 public function isTest($validator, $values)
 {
   if (isset($values'is_test')) {
     $this->validatorSchema['email_recipients']->addOption('required', false);
     $this->validatorSchema['test_recipient']->addOption('required', true);
   } else {
     $this->validatorSchema['email_recipients']->addOption('required', true);
     $this->validatorSchema['test_recipient']->addOption('required', false);
   }
   return $values;
 }

Le code est plus facile à maintenir: tout ce qui concerne la validation s’exécute uniquement dans des validateurs, sans passer par une méthode, bind qui n’a rien à voir avec ce processus.

mardi 9 décembre 2008

Task, application, environnement et fichier app.yml dans Symfony

Il est parfois utile que certaines tâches appartiennent à une application et soient exécutées dans un environnement donné. Ceci pour leur permettre d’accéder aux variables de configuration du fichier app.yml de l’application en question.

Pour obtenir ce résultat, il faut déclarer un argument 'application' et une option 'env', initialisés respectivement à l’application et à l’environnement souhaités. Cela une fonction configure qui commence ainsi:

class doHelloWorldTask extends sfBaseTask
{
 protected function configure()
 {
    $this->addOptions(array(
      new sfCommandOption('application', null, sfCommandOption::PARAMETER_REQUIRED, 'The application name', 'backend'),
      new sfCommandOption('env', null, sfCommandOption::PARAMETER_REQUIRED, 'The environment', 'dev'),
    ));
    [...]
 }

Ensuite il est alors possible d’accéder aux données du fichier app.yml de l’application en question. Exemple dans la fonction execute:

 protected function execute($arguments = array(), $options = array())
 {
   $conn_id = @ftp_connect(sfConfig::get('app_ftp_server_host')); 
   [...]
 }

L’inconvénient de cette méthode est qu’elle ne permet pas de figer l’application dans la tâche.