Zentrale, strikt pruefende Eingabevalidierung. More...

Inheritance diagram for dbxValidator:

Public Member Functions
	setLanguage (string $language='')
	Setzt die Sprache für folgende Validierungen explizit.
	getLanguage ()
	Liefert die aktuell wirksame Sprache.
	validateResult ($value, $rules='parameter', $name='-undef-')
	Validiert einen Wert und liefert ein maschinenlesbares Ergebnis.
	validate ($value, $rules='parameter', $name='-undef-')
	Rueckwaertskompatibler boolescher Einstieg.
	clean ($value, $rules, $length=-1, $name='-undef-')
	Historische Fehlerbehandlung fuer den DB-Clean-Modus.
	getErrorMessages ()
	getErrors ()
	Liefert die strukturierten Fehler des letzten Validierungslaufs.
	getLastResult ()
	Liefert das vollstaendige Ergebnis des letzten Validierungslaufs.
	clearErrors ()
	get_rule_val ($rules, $rule='')

Detailed Description

Zentrale, strikt pruefende Eingabevalidierung.

validate() bleibt der rueckwaertskompatible boolesche Einstieg. validateResult() liefert zusaetzlich einen stabilen Fehlercode, eine lesbare Meldung, den normalisierten Wert und regelabhaengige Details.

Wichtige Regeln

Leere Werte bleiben aus Kompatibilitaetsgruenden optional.
required macht einen Wert ausdruecklich zum Pflichtwert.
trim normalisiert Zeichenketten vor Laengen- und Formatpruefung.
min und max bezeichnen bei Zeichenketten die Unicode-Zeichenanzahl.
array prueft jedes Element mit der angegebenen Basisregel.
* deaktiviert die inhaltliche Pruefung bewusst vollstaendig.

Validierung ist keine HTML-Behandlung. Kontextgerechtes Escaping erfolgt erst bei der Ausgabe durch dbxForm/dbxTPL beziehungsweise deren Renderer.

Definition at line 22 of file dbxValidator.class.php.

Member Function Documentation

◆ clean()

dbxValidator::clean	(	$value,
		$rules,
		$length = -1,
		$name = '-undef-' )

Historische Fehlerbehandlung fuer den DB-Clean-Modus.

Die Methode escaped und filtert absichtlich nicht. Sie begrenzt nur die Laenge, nachdem die eigentliche Validierung fehlgeschlagen ist. Fuer neue Aufrufer sind validateResult() und dessen normalized-Wert vorzuziehen.

Parameters

mixed	$value	Eingabewert
string	$rules	Nur aus Kompatibilitaetsgruenden vorhanden
int	$length	Maximale Byte-Laenge; -1 deaktiviert das Kuerzen
string	$name	Feldname fuer kompatible Signatur

Returns: string

Definition at line 787 of file dbxValidator.class.php.

References $rules, and $value.

◆ clearErrors()

dbxValidator::clearErrors ( )

Definition at line 824 of file dbxValidator.class.php.

Referenced by validateResult().

◆ get_rule_val()

dbxValidator::get_rule_val	(		$rules,
			$rule = '' )

Definition at line 839 of file dbxValidator.class.php.

References $rule, and $rules.

◆ getErrorMessages()

dbxValidator::getErrorMessages ( )

Definition at line 806 of file dbxValidator.class.php.

◆ getErrors()

dbxValidator::getErrors ( )

Liefert die strukturierten Fehler des letzten Validierungslaufs.

Definition at line 813 of file dbxValidator.class.php.

◆ getLanguage()

dbxValidator::getLanguage ( )

Liefert die aktuell wirksame Sprache.

Definition at line 431 of file dbxValidator.class.php.

◆ getLastResult()

dbxValidator::getLastResult ( )

Liefert das vollstaendige Ergebnis des letzten Validierungslaufs.

Definition at line 820 of file dbxValidator.class.php.

◆ setLanguage()

dbxValidator::setLanguage ( string $language = '' )

Setzt die Sprache für folgende Validierungen explizit.

Ein leerer Wert aktiviert wieder die automatische UI-Sprache.

Definition at line 424 of file dbxValidator.class.php.

◆ validate()

dbxValidator::validate	(	$value,
		$rules = 'parameter',
		$name = '-undef-' )

Rueckwaertskompatibler boolescher Einstieg.

Fuer Fehlercode, normalisierten Wert und Details validateResult() nutzen.

Definition at line 764 of file dbxValidator.class.php.

References $result, $rules, $value, and validateResult().

◆ validateResult()

dbxValidator::validateResult	(	$value,
		$rules = 'parameter',
		$name = '-undef-' )

Validiert einen Wert und liefert ein maschinenlesbares Ergebnis.

Die Schluessel code und details sind fuer Programmlogik bestimmt; message ist eine allgemeine Fallback-Meldung. Formulare duerfen diese weiterhin durch eine fachlich genauere Feldmeldung ersetzen.