Omejitve izpisov podatkovne zbirke - LIMIT

Kadar ne želimo prikazati vseh zapisov naenkrat, lahko izpis omejimo. V MySQL oziroma MariaDB za to uporabimo ukaza LIMIT in OFFSET.

Omejen izpis je uporaben pri daljših seznamih, pri preglednejšem prikazu podatkov in pri pripravi paginacije. Namesto da uporabniku prikažemo vse zapise hkrati, mu lahko prikažemo samo določen del rezultatov.

Vsebina strani

Osnovna pravila

Pri omejenem izpisu določimo, koliko zapisov želimo prikazati in od katerega mesta v rezultatu naj se prikaz začne.

• Za določanje števila prikazanih zapisov uporabimo LIMIT.
• Za določanje začetnega odmika uporabimo OFFSET.
• Vrednost pri LIMIT mora biti pozitivno celo število.
• Vrednost pri OFFSET mora biti celo število, ki je večje ali enako nič.
• Rezultate pred omejitvijo uredimo z ukazom ORDER BY.
• Če uporabnik vnese neveljavne vrednosti, uporabimo privzeti izpis ali prikažemo opozorilo.
• Pri izpisu podatkov uporabimo htmlspecialchars().

SELECT *
FROM imeTabele
LIMIT steviloZapisov;

SELECT *
FROM imeTabele
LIMIT steviloZapisov OFFSET zacetek;

SELECT *
FROM knjige
ORDER BY ID_knjige
LIMIT 5 OFFSET 2;

<?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() . ')'
    );
}

$stevilo = trim($_POST['stevilo'] ?? '');
$start = trim($_POST['start'] ?? '');

$steviloValid = filter_var($stevilo, FILTER_VALIDATE_INT);
$startValid = filter_var($start, FILTER_VALIDATE_INT);

if ($steviloValid !== false && $startValid !== false && (int)$stevilo > 0 && (int)$start >= 0) {
    $stmt = mysqli_prepare(
        $connection,
        "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
         FROM knjige
         ORDER BY ID_knjige
         LIMIT ? OFFSET ?"
    );
    mysqli_stmt_bind_param($stmt, 'ii', $steviloValid, $startValid);
    mysqli_stmt_execute($stmt);
    $result = mysqli_stmt_get_result($stmt);
} else {
    $result = mysqli_query(
        $connection,
        "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
         FROM knjige
         ORDER BY ID_knjige"
    );
}

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

if (isset($stmt)) {
    mysqli_stmt_close($stmt);
}
mysqli_close($connection);
?>

Pri mysqli vrednosti za LIMIT in OFFSET preverimo kot cela števila, nato ju vežemo kot parametra 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);

    $stevilo = trim($_POST['stevilo'] ?? '');
    $start = trim($_POST['start'] ?? '');

    $steviloValid = filter_var($stevilo, FILTER_VALIDATE_INT);
    $startValid = filter_var($start, FILTER_VALIDATE_INT);

    if ($steviloValid !== false && $startValid !== false && (int)$stevilo > 0 && (int)$start >= 0) {
        $stmt = $pdo->prepare(
            "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
             FROM knjige
             ORDER BY ID_knjige
             LIMIT :stevilo OFFSET :start"
        );
        $stmt->bindValue(':stevilo', (int)$stevilo, PDO::PARAM_INT);
        $stmt->bindValue(':start', (int)$start, PDO::PARAM_INT);
        $stmt->execute();
    } else {
        $stmt = $pdo->prepare(
            "SELECT ID_knjige, Priimek_avtorja, Ime_avtorja, Naslov, Strani, Cena, Leto
             FROM knjige
             ORDER BY ID_knjige"
        );
        $stmt->execute();
    }

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

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

Pri PDO vrednosti za LIMIT in OFFSET vežemo kot cela števila z PDO::PARAM_INT. Tako preprečimo, da bi se v poizvedbo vključile neustrezne vrednosti.

Preverjanje vrednosti za omejen izpis

Pred uporabo ukazov LIMIT in OFFSET moramo preveriti, ali je uporabnik vnesel veljavni celi števili.

• število zapisov mora biti pozitivno celo število,
• začetni odmik mora biti nič ali več,
• če podatka nista pravilna, uporabniku pokažemo opozorilo ali izpišemo vse zapise,
• omejen izpis je najbolj smiseln skupaj z urejenim prikazom zapisov.

$steviloValid = filter_var($stevilo, FILTER_VALIDATE_INT);
$startValid = filter_var($start, FILTER_VALIDATE_INT);

if ($steviloValid === false || $startValid === false) {
    echo 'Vneseni vrednosti nista veljavni celi števili.';
}

Povezava z paginacijo rezultatov

Ukaza LIMIT in OFFSET se pogosto uporabljata pri paginaciji rezultatov. Pri tem se velik seznam razdeli na več strani.

Če želimo na vsaki strani prikazati 10 zapisov, lahko odmik izračunamo iz številke strani:

$naStran = 10;
$stran = 3;
$offset = ($stran - 1) * $naStran;

Za tretjo stran je odmik 20, saj se prvih 20 zapisov preskoči, nato pa se prikaže naslednjih 10 zapisov.

SELECT *
FROM knjige
ORDER BY ID_knjige
LIMIT 10 OFFSET 20;

Primerjava pristopov mysqli in PDO

Oba pristopa omogočata omejen izpis s preverjenimi številskimi parametri. Razlikujeta se predvsem v načinu vezave parametrov in branju rezultatov.

Aplikacija Knjige

Navodila za izdelavo aplikacije Knjige

Priporočila

• Za omejen izpis uporabi LIMIT.
• Za začetni odmik uporabi OFFSET.
• Vrednosti za LIMIT in OFFSET vedno preveri kot cela števila.
• Število zapisov naj bo večje od 0.
• Začetni odmik naj bo večji ali enak 0.
• Rezultate vedno uredi z ORDER BY.
• Pri večjih seznamih razmisli o paginaciji rezultatov.
• Uporabniku prikaži opis izpisa in število prikazanih zapisov.

Pogoste napake

• Vrednosti za LIMIT in OFFSET niso preverjene.
• Za število zapisov je dovoljena vrednost 0, zato se ne prikaže noben zapis.
• Začetni odmik je negativen.
• Ukaz LIMIT je uporabljen brez ORDER BY, zato je izpis manj predvidljiv.
• Uporabniku ni jasno prikazano, kateri del rezultatov gleda.
• Ni predvidenega odziva za neveljavne vrednosti obrazca.
• Pri izpisu podatkov manjka htmlspecialchars().
• Pri paginaciji je napačno izračunan začetni odmik.