Adatvalidálás

Az adatvalidálást az Úr találta ki azzal, hogy megadta nekünk a juzert, aki vagy nem akarja, vagy alapból nem tudja mit kell kitölteni a formon, vagy milyen formátumú adatot kell beírni. Bemutatunk ehhez egy könnyen kezelhető validátor classt, és egy eljárást, hogy is használjuk.

Példánkban kérjünk be:

• e-mail címet: szükséges ($email)
• webcímet: opcionális ($web)
• születési dátum: opcionális ($bday) //2000-03-03
• a user nevét: szükséges ($name)

A változókba bekerültek az értékek, döntsük el, hogy helyesek-e, vagy újra be kell kérni.

A működés tehát:

$validator = new validator();
$validator->item($email, array("required","email"),array("Hiányzó e-mail cím!","Hibás e-mail cím"));
$validator->item($web, array("url"),array("Hibás webcím"));
$validator->item($bday, array("date"),array("Hibás születési dátum"));
$validator->item($name, array("required"),array("Hiányzó név"));
if ($validator->valid()){
//az adatok helyesek, dolgozhatunk tovább
} else {
//nem nyert, ez az üzenet, újra be kell kérni az adatokat
$message = $validator->message();
}

// $validator->item(változó, array("szabály 1","szabály 2"),array("üzenet, ha az első false","üzenet, ha a második false"));

Természetesen a tömbök n elemig bővíthetőek, és a két tömb elemszáma egyező legyen, hogy mindegyikhez kapjunk hibaüzenetet.

További lehetőségek:

if (nagyon bonyolult feltétel és sok){
$validator->set_valid(false,"üzenet, ha false, mert manualisan állítottuk be a hibát");
}

$items = array(
"email"=>$email,
"web"=>$web,
"bday"=>$bday,
"name"=>$name
);

$rules = array(
"email"=>array(array("required","email"),array("Hiányzó e-mail cím!","Hibás e-mail cím")),
"web"=>array(array("url"),array("Hibás webcím")),
"bday"=>array(array("date"),array("Hibás születési dátum")),
"name"=>array(array("required"),array("Hiányzó név"))
);

$validator->validate($rules, $items);
if ($validator->valid()){
// a korábbi formula
}

Ez annyiban különbözik, hogy a $validator->item(); tömbből fogja megkapni az értékeit. Miért jó ez? Ebben az esetben például:

<input type="text" name="adat[email]" />
<input type="text" name="adat[web]" />
<input type="text" name="adat[bday]" />
<input type="text" name="adat[name]" />

POST után a változók a $_POST["adat"] tömbben lesznek. Ekkor: $items = $_POST["adat"];
Így ha új mező kerül a formba, csak a html-t kell módosítani, és a rules array-t. Ennek igazán akkor van haszna, ha rengeteg mező van egy formon, ebben az esetben a $rules változó külön kiírható egy fileba, amit a “felhasználó” is tud módosítani , átláthatóbbá válik a kezelés.

Az újrahasznosítás jegyében validátorunkat classként használjuk, így a feltételek folyamatosan bővíthetők a fejlesztések közben(új case elemmel), ha esetlegesen új validálási igények jönnek be.

Akik szeretik a többnyelvű alkalmazásokat, azok is használhatják, hiszen fix string helyett a nyelvi változóban az ide fenntartott szöveg is berakható, mint változó.

A class itt tölthető le, vagy itt tekinthető meg. Na?