Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

v5.5

...

 

...

...

...

Dieses Plugin wird von brandbox base genutzt um Benutzereingaben direkt vor dem Speichern eines Datenbankobjektes zu prüfen. Dadurch wird jedes generalisierte Formular in der Administrationsoberfläche von brandbox automatisch validiert. Die zu prüfenden Kriterien (Constraints) müssen entweder im Programmcode bei einer Objekteigenschaft oder über die Datenmodellierung festgelegt werden.

...

Kriterien

...

Zusätzlich zu den von Symfony bereitgestellten Constraint-Klassen stellt brandbox die folgenden weitere Constraints zur Verfügung. Eine Übersicht der verfügbaren Kriterien finden sie hier.

Info

Durch brandbox bereitgestellte Constraints dürfen ausschließlich über die Datenmodellierung oder den @constraint [Constraint] Syntax genutzt werden. Der Standard-Symfony-Syntax wird nicht unterstützt.

...

Konfiguration

Validierungskriterien müssen entweder über den Programmcode oder die Datenmodellierung definiert werden. In allen Fällen ist die Syntax für ein Kriterium zu befolgen.

RDark
Codeblock
theme
Kriterium(parameter="wert", parameter=wert)

Kriterien über die Datenmodellierung festlegen

Siehe die entsprechende Dokumentation der Datenmodellierung.

Kriterien über den Programmcode festlegen

Über den Programmcode können Kriterien pro Datenbankspalte oder für das gesamte Datenbankobjekt festgelegt werden. Für ein Kriterium welches für ein ganzes Datenbankobjekt gelten soll wird ein anderer Syntax genutzt.

Kriterien pro Datenbankspalte
title
Codeblock
languagephp
themeRDark
titleKriterien pro Datenbankspalte
collapsetrue
<?php

declare(strict_types=1);

/**

  * In diesem Beispiel wird die Klasseneigenschaft $property 
   * mit drei Kriterien für die Validierung versehen.
 *
 * 1: IsCombinedUnique(...) prüft die Eindeutigkeit der Kombination aus den definierten Spalten.
 *
1 * 2. NotBlank() erfordert einen gültigen Wert in $property. 
 
 *               Werte welche null entsprechen sind verboten.
 *
 * 23. Length(...) erfordert das der Wert mindesten 3 und 
 
 *                maximal 255 Zeichen umfassen darf. 
 
 *                Ein Wert welcher null entspricht ist 
   *                ohne NotBlank() ebenfalls gültig.
 *
 * 34. Regex(...) legt einen regulären Ausdruck fest welcher 
   *               mit dem Wert von $property geprüft wird. 
 
 *               Sollte der Wert null entsprechenden wird 
 
 *               er ohne NotBlank() als gültig angesehen.
 
 */



namespace brandboxBrandbox\SampleCore\sampleSample\pluginPlugin\libLib\entityEntity {

    	use brandboxBrandbox\Framework\componentComponent\doctrineDoctrine;

	/**
	 *  /**
    @constraint IsCombinedUnique(columns="property,something")
	 * 
	 * [Deklaration als Doctrine-Entity]
	     */
    	class sampleSample extends doctrineDoctrine\libDefinition\entityAbstractEntityAbstract
	{

      		/**
       * @var string
       *
       		 * @constraint NotBlank()
       		 * @constraint Length(min=3, max=255)
       		 * @constraint Regex(pattern="/^[a-z]+$/Ui")
		 *
		 * [@Column...-Deklaration]
		 */
*		public string $property = 'example';

		/**
		 * [@Column...-Deklaration]
       		 */
		public      public $propertystring $something = 'examplestrange';

    }

  }

?>
Codeblock
languagephp
themeRDark
	}
}


Ein benutzerdefiniertes Kriterium für ein Datenbankobjekt
Codeblock
collapselanguagetruephp
<?php

declare(strict_types=1);

/**
 
 * In diesem Beispiel wird eine Validierungsmethode für das Datenbankobjekt definiert.
 
 * Wird eine Validierung auf diesem Objekt ausgeführt wird die Methode callback() aufgerufen.

  * Dort findest eine speziell für dieses Datenbankobjekt erforderliche Prüfung statt.
   * Im Fehlerfall wird eine entsprechende Fehlermeldung erzeugt.

  */

  namespace brandboxBrandbox\SampleCore\sampleSample\pluginPlugin\libLib\entityEntity {

    	use brandboxBrandbox\Framework\componentComponent\doctrineDoctrine;

    	use /** @noinspection PhpUnusedAliasInspection */ Symfony\Component\Validator\Constraints;
    	use Symfony\Component\Validator\Context\ExecutionContextInterface;

    	/**
	     * [Deklaration als Doctrine-Entity]
    	 */
    	class sampleSample extends doctrineDoctrine\libDefinition\entityAbstractEntityAbstract 
	{

      		/**
       * @var string
       *
       * 		 * [@Column...-Deklaration]
      		 */
		public string     public $username;

      		/**
       * @var string
       *
      		 * [@Column...-Deklaration]
      		 */
      public 		public string $password;

      		/**
       * @var string
     
 *        * [@Column...-Deklaration]
         */
      public		public string $email;

      		/**
      		 * @Constraints\Callback
       *
       * @param ExecutionContextInterface $context
       *
       * @return void
       */
      		 */
		public function callback(ExecutionContextInterface $context): {void 
        		{
			$required = $this->username . '@example.com';

       			if(0 !== strcmp($required, $this->email)): 
          $context
             {
				$context
					->buildViolation('You must provide a correct email address.')
             					->atPath('email')
             					->addViolation()
          ;

        endif;

      }

    }

  }

?>				;
			}
		}
	}
}

Verwendung

Hauptsächlich wird dieses Plugin genutzt um Datenbankobjekte zu validieren. Es kann allerdings auch auf andere Klassenobjekte angewendet werden. Um ein Objekt zu validieren kann folgender Code genutzt werden.

Verwendung der Validierungskomponente
Codeblock
collapse
languagephp
themeRDark
titleVerwendung der Validierungskomponente
true
<?php

declare(strict_types=1);

namespace brandboxBrandbox\SampleCore\sampleSample\pluginPlugin\libLib\executeExecute {

    use brandbox\admin\plugin;

    use brandbox\component\http;
    use brandbox\component\doctrine;
    use brandbox\component\validator;

    /**
     * @author Max Mustermann <mustermann@example.com>
     */
    class example extends plugin\lib\executeAbstract {

      use validator\validatorTrait;

      /**
       * @param doctrine\lib\entityAbstract $entity
       *
       * @return http\response\responseAbstract
       */
      public function execute($entity) {

        $locale = $this->getApplicationLanguage();

        return $this->validateValue($entity, $locale, function() use ($entity) {

          $entity->save();

          return new http\response\location('http://example.com/');

        });

      }

    }

  }

?>

...