Zentrale, strikt prüfende Eingabevalidierung. Mehr ...

Öffentliche Methoden
	set_language (string $language='')
	Setzt die Sprache für folgende Validierungen explizit.
	get_language ()
	Liefert die aktuell wirksame Sprache.
	validate_result ($value, $rules='parameter', $name='-undef-')
	Validiert einen Wert und liefert ein maschinenlesbares Ergebnis.
	validate ($value, $rules='parameter', $name='-undef-')
	Rückwärtskompatibler boolescher Einstieg.
	clean ($value, $rules, $length=-1, $name='-undef-')
	Historische Fehlerbehandlung für den DB-Clean-Modus.
	get_error_messages ()
	get_errors ()
	Liefert die strukturierten Fehler des letzten Validierungslaufs.
	get_last_result ()
	Liefert das vollständige Ergebnis des letzten Validierungslaufs.
	clear_errors ()
	get_rule_val ($rules, $rule='')

Ausführliche Beschreibung

Zentrale, strikt prüfende Eingabevalidierung.

validate() bleibt der rückwärtskompatible boolesche Einstieg. validateResult() liefert zusätzlich einen stabilen Fehlercode, eine lesbare Meldung, den normalisierten Wert und regelabhängige Details.

Wichtige Regeln

Leere Werte bleiben aus Kompatibilitätsgründen optional.
required macht einen Wert ausdrücklich zum Pflichtwert.
trim normalisiert Zeichenketten vor Längen- und Formatprüfung.
min und max bezeichnen bei Zeichenketten die Unicode-Zeichenanzahl.
array prüft jedes Element mit der angegebenen Basisregel.
* deaktiviert die inhaltliche Prüfung bewusst vollständig.

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

Dokumentation der Elementfunktionen

◆ clean()

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

Historische Fehlerbehandlung für den DB-Clean-Modus.

Die Methode escaped und filtert absichtlich nicht. Sie begrenzt nur die Länge, nachdem die eigentliche Validierung fehlgeschlagen ist. Für neue Aufrufer sind validateResult() und dessen normalized-Wert vorzuziehen.

Parameter

mixed	$value	Eingabewert
string	$rules	Nur aus Kompatibilitätsgründen vorhanden
int	$length	Maximale Byte-Länge; -1 deaktiviert das Kürzen
string	$name	Feldname für kompatible Signatur

Rückgabe: string

◆ clear_errors()

dbxValidator::clear_errors ( )

Wird benutzt von validate_result().

◆ get_error_messages()

dbxValidator::get_error_messages ( )

◆ get_errors()

dbxValidator::get_errors ( )

Liefert die strukturierten Fehler des letzten Validierungslaufs.

◆ get_language()

dbxValidator::get_language ( )

Liefert die aktuell wirksame Sprache.

◆ get_last_result()

dbxValidator::get_last_result ( )

Liefert das vollständige Ergebnis des letzten Validierungslaufs.

◆ get_rule_val()

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

◆ set_language()

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

Setzt die Sprache für folgende Validierungen explizit.

Ein leerer Wert aktiviert wieder die automatische UI-Sprache.

◆ validate()

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

Rückwärtskompatibler boolescher Einstieg.

Für Fehlercode, normalisierten Wert und Details validateResult() nutzen.

Benutzt $result und validate_result().

◆ validate_result()

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

Validiert einen Wert und liefert ein maschinenlesbares Ergebnis.

Die Schlüssel code und details sind für Programmlogik bestimmt; message ist eine allgemeine Fallback-Meldung. Formulare dürfen diese weiterhin durch eine fachlich genauere Feldmeldung ersetzen.