Filtriranje izpisov podatkovne zbirke - WHERE

Pri večjem številu zapisov je koristno, da podatke omejimo glede na izbran pogoj. Tak postopek imenujemo filtriranje. V MySQL oziroma MariaDB za filtriranje najpogosteje uporabimo pogoj WHERE.

Filtriranje je pomembno v spletnih aplikacijah, ker uporabniku omogoči, da hitro najde samo tiste zapise, ki ga zanimajo. V aplikaciji Knjige lahko na primer prikažemo vse knjige ali pa samo knjige iz izbranega leta.

Vsebina strani

Osnovna pravila

Pri filtriranju podatkov določimo pogoj, ki ga morajo zapisi izpolnjevati. Rezultat poizvedbe vsebuje samo tiste vrstice, ki ustrezajo izbranemu pogoju.

• Za filtriranje zapisov uporabimo pogoj WHERE.
• Filter lahko temelji na številskem, besedilnem ali datumskem stolpcu.
• Pri filtriranju po letu uporabimo stolpec Leto.
• Če uporabnik izbere prikaz vseh zapisov, poizvedbo izvedemo brez pogoja WHERE.
• Če uporabnik izbere določeno vrednost, uporabimo pripravljen stavek s parametrom.
• Rezultate lahko uredimo z ukazom ORDER BY.
• Pri izpisu rezultatov uporabimo htmlspecialchars().

SELECT stolpec1, stolpec2
FROM imeTabele
WHERE pogoj;

SELECT *
FROM knjige
WHERE Leto = 2024;

SELECT *
FROM knjige
WHERE Leto = 2024
ORDER BY ID_knjige;

<?php
define('DB_SERVER', 'localhost');
define('DB_USER', 'uporabnik');
define('DB_PASS', 'skritoGeslo');
define('DB_NAME', 'knjiznica');

// Povezava do podatkovne zbirke
$connection = mysqli_connect(DB_SERVER, DB_USER, DB_PASS, DB_NAME);

// Preverjanje povezave
if (!$connection) {
    die(
        'Povezava s podatkovno zbirko ni vzpostavljena: ' .
        mysqli_connect_error() .
        ' (' . mysqli_connect_errno() . ')'
    );
}

$izbranoLeto = (int)($_POST['leto'] ?? 0);

if ($izbranoLeto === 0) {
    $stmt = mysqli_prepare(
        $connection,
        "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
         FROM knjige
         ORDER BY ID_knjige"
    );
} else {
    $stmt = mysqli_prepare(
        $connection,
        "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
         FROM knjige
         WHERE Leto = ?
         ORDER BY ID_knjige"
    );
    mysqli_stmt_bind_param($stmt, 'i', $izbranoLeto);
}

mysqli_stmt_execute($stmt);
$result = mysqli_stmt_get_result($stmt);

while ($row = mysqli_fetch_assoc($result)) {
    echo htmlspecialchars($row['Naslov']) . '<br>';
}

mysqli_stmt_close($stmt);
mysqli_close($connection);
?>

Pri mysqli pripravimo različno poizvedbo glede na izbiro uporabnika. Če uporabnik izbere prikaz vseh zapisov, pogoj WHERE ni potreben. Če izbere določeno leto, vrednost leta vežemo s funkcijo mysqli_stmt_bind_param().

<?php
$streznik = 'localhost';
$baza = 'knjiznica';
$uporabnik = 'uporabnik';
$geslo = 'skritoGeslo';

try {
    $pdo = new PDO("mysql:host=$streznik;dbname=$baza;charset=utf8mb4", $uporabnik, $geslo);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    $izbranoLeto = trim($_POST['leto'] ?? '0');

    if ($izbranoLeto === '0') {
        $stmt = $pdo->prepare(
            "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
             FROM knjige
             ORDER BY ID_knjige"
        );
        $stmt->execute();
    } else {
        $stmt = $pdo->prepare(
            "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
             FROM knjige
             WHERE Leto = :leto
             ORDER BY ID_knjige"
        );
        $stmt->bindValue(':leto', (int)$izbranoLeto, PDO::PARAM_INT);
        $stmt->execute();
    }

    $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

    foreach ($rows as $row) {
        echo htmlspecialchars($row['Naslov']) . '<br>';
    }
}
catch (PDOException $e) {
    echo 'Napaka pri filtriranju podatkov: ' . $e->getMessage();
}
?>

Pri PDO pripravljen stavek pripravimo z metodo prepare(), vrednost filtra povežemo z metodo bindValue(), rezultate pa preberemo z metodo fetchAll().

Filter prek obrazca

V spletni aplikaciji filter običajno povežemo z obrazcem. Pri filtriranju po letu lahko uporabimo spustni seznam, v katerem je vrednost 0 namenjena prikazu vseh zapisov.

<form method="post" action="09_filter.php">
    <label for="leto">Izberi leto:</label>
    <select name="leto" id="leto">
        <option value="0">Vsa leta</option>
        <option value="2021">2021</option>
        <option value="2022">2022</option>
        <option value="2023">2023</option>
    </select>
    <button type="submit">Filtriraj</button>
</form>

V boljši izvedbi vrednosti za spustni seznam ne vpišemo ročno, ampak jih preberemo iz tabele. Tako se seznam samodejno prilagodi podatkom, ki so v bazi.

SELECT DISTINCT Leto
FROM knjige
ORDER BY Leto;

Preverjanje izbranega filtra

Pred izvedbo filtra moramo preveriti, ali je uporabnik izbral veljavno vrednost. Če je vrednost napačna, lahko uporabniku prikažemo opozorilo ali pa izpišemo vse zapise.

• preverimo, ali je bil obrazec oddan,
• preberemo izbrano vrednost iz obrazca,
• preverimo, ali je leto veljavno celo število,
• vrednost 0 obravnavamo kot prikaz vseh zapisov,
• če filter ni veljaven, uporabniku pokažemo opozorilo.

$izbranoLeto = trim($_POST['leto'] ?? '0');

if ($izbranoLeto !== '0' && !ctype_digit($izbranoLeto)) {
    echo 'Izbrani filter ni veljaven.';
}

Primerjava filtriranja z mysqli in PDO

Oba pristopa omogočata filtriranje s pripravljenimi stavki. Razlika je predvsem v načinu vezave parametrov in branju rezultatov.

Aplikacija Knjige

Navodila za izdelavo aplikacije Knjige

Priporočila

• Za filtriranje uporabi pogoj WHERE.
• Vrednosti za spustni seznam po možnosti preberi iz podatkovne baze.
• Vrednost 0 lahko uporabiš za prikaz vseh zapisov.
• Vrednost filtra vedno preveri na strežniku.
• Za uporabniški vnos uporabi pripravljen stavek.
• Rezultate uredi z ORDER BY.
• Pri izpisu rezultatov uporabi htmlspecialchars().
• Uporabniku prikaži opis izbranega filtra in število zadetkov.

Pogoste napake

• Vrednost filtra je neposredno vključena v poizvedbo.
• Vrednost iz obrazca ni preverjena na strežniku.
• Ni predvidene možnosti za prikaz vseh zapisov.
• Poizvedba z uporabo WHERE ni izvedena s pripravljenim stavkom.
• Rezultati niso urejeni z ORDER BY, zato je vrstni red nepredvidljiv.
• Pri izpisu rezultatov manjka htmlspecialchars().
• Uporabniku ni jasno prikazano, kateri filter je trenutno izbran.
• Ni izpisano število najdenih zapisov.