utils.php File Reference

Functions
	addIfChanged (array $payload, string $key, ?string $new, ?string $old)
	allNotEmpty (... $args)
	boolIcon ($value, string $trueText='vorhanden', string $falseText='fehlt')
	Erzeugt ein farbiges Bootstrap-Icon für boolesche Zustände. More...
	buildFilterWhereClause (array $filters, array $mapping)
	Erstellt eine SQL-WHERE-Klausel mit Platzhaltern und bind-Param-Werten. More...

Function Documentation

addIfChanged()

addIfChanged	(	array	$payload,
		string	$key,
		?string	$new,
		?string	$old
	)

Prüft, ob die übergebenen Werte verschieden sind und fügt sie dann in das Arry ein

Parameters

array	$payload	Array was die JSON Daten bekommt
string	$key	Schlüssel
string	$new	neuer Wert
string	$old	alter Wert

Returns

array [ 'key' => Schlüssel 'new' => neuer Wert]

allNotEmpty()

allNotEmpty

(

$args

)

Prüft, ob alle übergebenen Werte nicht leer sind (''), aber erlaubt '0' und andere "falsey" Werte.

Parameters

mixed

...$args Beliebig viele Parameter

Returns

bool true, wenn keiner der Werte ein leerer String ist

boolIcon()

boolIcon	(		$value,
		string	$trueText = 'vorhanden',
		string	$falseText = 'fehlt'
	)

Erzeugt ein farbiges Bootstrap-Icon für boolesche Zustände.

Diese Funktion wandelt einen Wahrheitswert (z. B. 1 oder 0) in ein Bootstrap-Icon um. Dabei wird für 1 ein grünes Häkchen angezeigt, für 0 ein rotes Kreuz und für leere oder null-Werte ein graues Platzhalter-Icon.

Zusätzlich können Tooltips (per HTML-title-Attribut) für die Zustände „true“ und „false“ angegeben werden.

Beispiel:

echo boolIcon(1, 'Aktiv', 'Inaktiv');
// ➜ Gibt aus: <i class='text-success bi bi-check-circle' title='Aktiv'></i>

Parameters

mixed	$value	Wahrheitswert (1, 0, true, false oder null)
string	$trueText	Tooltip-Text, wenn $value positiv ist (Standard: "vorhanden")
string	$falseText	Tooltip-Text, wenn $value negativ ist (Standard: "fehlt")

Returns

string HTML-String mit passendem Bootstrap-Icon und Tooltip.

buildFilterWhereClause()

buildFilterWhereClause	(	array	$filters,
		array	$mapping
	)

Erstellt eine SQL-WHERE-Klausel mit Platzhaltern und bind-Param-Werten.

Diese Funktion verarbeitet POST-Filter und erzeugt daraus eine SQL-WHERE-Klausel, Parameterliste und Typenfolge für Prepared Statements.

Parameters

array	$filters	POST-Daten (z. B. $_POST).
array	$mapping	Assoziatives Array: Key = POST-Key (z. B. 'in_league_filter'), Value = ['column' => Spaltenname, 'type' => Typ: 'i', 's', 'd', 'b' oder 'date_future']

Returns

array [ 'sql' => string WHERE-Klausel (z. B. "WHERE league_id IN (?,?) AND home_away_id = ?"), 'params' => array Parameterwerte (z. B. [2, 5, 1]), 'types' => string Typenfolge (z. B. "iii") ]