Databáze & ORM

Základem je obálka nad PDO nazvaná Nette\Database\Connection:

use Nette\Database\Connection;

$database = new Connection($dsn, $user, $password);

Po připojení se automaticky zobrazí panel na Debugger baru. Ten nás informuje o všech vykonaných SQL dotazech, době jejich vyřízení, počtu vrácených řádků, dokonce uvádí i jejich EXPLAIN podobu a místo, v kódu, kde byl dotaz volán.

Oproti PDO dovoluje Connection uvádět v příkazech exec a query výčet parametrů:

$database->exec('INSERT INTO users', array( // parametrem může být pole
    'name' => 'Jim',
    'created' => new DateTime, // nebo objekt DateTime
    'avatar' => fopen('image.gif', 'r'), // nebo soubor
), ...); // lze použít i vícenásobný insert

$database->exec('UPDATE users SET ? WHERE id=?', $data, $id);

$database->query('SELECT * FROM categories WHERE id=?', 123)->dump();

Práce s tabulkami

Pro složitější výběry lze použít nástroj, který vychází z výborné knihovny NotORM a nabízí čitelnější API. Databázi na obrázku lze procházet takto:

Příklad SQL databáze

foreach ($database->table('book')->order('title')->limit(5) as $book)
{
    echo $book->title, ' (', $book->author->name, ')';
    // ekvivalentní s $book['title'], ' (', $book['author']['name'], ')';

    foreach ($book->related('book_tag') as $book_tag) {
        echo $book_tag->tag->name . ', ';
    }
}

V šabloně by se použil pochopitelně Latte-zápis:

{foreach $database->table('book')->order('title')->limit(5) as $book}
    <h2>{$book->title} ({$book->author->name})</h2>

    {foreach $book->related('book_tag') as $book_tag}
        {$book_tag->tag->name}{sep}, {/sep}
    {/foreach}
{/foreach}

Efektivita

Budete nadšeni, jak efektivně databázová vrstva pracuje. Žádné sloupce se zbytečně nepřenášejí vícekrát. Uvedený příklad pokládá tyto dotazy:

SELECT * FROM `book` ORDER BY title LIMIT 5

SELECT * FROM `author` WHERE (`author`.`id` IN (11, 12))

SELECT * FROM `book_tag` WHERE (`book_tag`.`book_id` IN (1, 4, 2, 3))

SELECT * FROM `tag` WHERE (`tag`.`id` IN (21, 22, 23))

Při použití cache (zatím neimplementováno) se umí dotazovat jen na sloupce, které se skutečně použijí:

SELECT `id`, `title`, `author_id` FROM `book` ORDER BY title LIMIT 5

SELECT `id`, `name` FROM `author` WHERE (`author`.`id` IN (11, 12))

SELECT `book_id`, `tag_id` FROM `book_tag` WHERE (`book_tag`.`book_id` IN (1, 4, 2, 3))

SELECT `id`, `name` FROM `tag` WHERE (`tag`.`id` IN (21, 22, 23))

Table Selection API

(převzato z NotORM API)

Výrazy lze zřetězit, např. $table->where(...)->order(...)->limit(...). Více podmínek where se spojuje operátorem AND.

Pokud použijeme tečkovou notaci ("$table.$column"), automaticky se vytvoří spojení s odkazovanou tabulkou.

Lze také vytvářet agregační dotazy:

Získávání dat:

Práce s jedním řádkem:

$row = $this->getDatabase()
  ->table($this->table)
  ->where($paramName . ' = ?', $paramValue) //FIXME ! paramName not escaped
  ->fetch()

Login to submit a comment