Nette Database je výkonná a elegantní databázová vrstva pro PHP, která vyniká svou jednoduchostí použití a chytrými funkcemi. Nevyžaduje žádnou složitou konfiguraci nebo generování entit, s Nette Database můžete začít pracovat okamžitě.

Nette Database nabízí dva hlavní přístupy k práci s databází:

Instalace

Knihovnu stáhnete a nainstalujete pomocí nástroje Composer:

composer require nette/database

Připojení a konfigurace

Pro připojení k databázi vytvořte instanci třídy Nette\Database\Connection:

$db = new Nette\Database\Connection($dsn, $user, $password);

Parametr $dsn (data source name) používá stejný formát jako PDO, např. host=127.0.0.1;dbname=test.

Elegantněji můžete nastavit připojení pomocí konfiguračního souboru. Stačí přidat sekci database a framework se postará o vytvoření potřebných objektů včetně databázového panelu v Tracy.

database:
	dsn: 'mysql:host=127.0.0.1;dbname=test'
	user: root
	password: password

Objekt pro připojení pak získáte jako službu z DI kontejneru:

class Model
{
	// pro práci s vrstvou Database Explorer si předáme Nette\Database\Explorer
	public function __construct(
		private Nette\Database\Connection $db,
	) {
	}
}

Více informací o konfiguraci databáze.

Výběr vrstvy

Database Core je ideální pro přímou práci s SQL dotazy. Poskytuje bezpečné parametrizované dotazy a lepší API než PDO:

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

// SELECT dotazy
$result = $database->query('SELECT * FROM users WHERE role = ?', 'admin');
foreach ($result as $row) {
    echo $row->name;
}

// INSERT s pomocí pole
$database->query('INSERT INTO users', [
    'name' => 'John Doe',
    'email' => '[email protected]',
    'created_at' => new DateTime,
]);

Database Explorer nabízí intuitivní práci s databází bez nutnosti psát SQL dotazy:

// Vytvoření instance Exploreru
$explorer = new Nette\Database\Explorer($connection, $structure, $conventions);

// Načtení dat
// - automaticky optimalizuje dotazy
// - načítá pouze použité sloupce
$users = $explorer->table('users');

// Jednoduché filtrování
$users->where([
    'role' => 'admin',
    'active' => true,
]);

// Práce s relacemi
foreach ($users as $user) {
    // Automaticky vytvoří efektivní JOIN
    echo $user->name;  // jméno uživatele
    echo $user->role->description;  // popis role z propojené tabulky

    // Výpis všech článků uživatele
    foreach ($user->related('articles') as $article) {
        echo $article->title;
    }
}

// Vložení dat
$users->insert([
    'name' => 'John Doe',
    'email' => '[email protected]',
]);

Obě vrstvy lze v aplikaci kombinovat – pro běžné operace použít Explorer a pro specifické případy přepnout na Core.

$database->query('
	SELECT *
	FROM users
	WHERE name =', $name
);

$book = $explorer->table('book')->get(1);
// automaticky nalezne vazbu přes book.author_id
echo $book->author->name;

foreach ($books as $book) {
	// načte z databáze jen sloupec 'title'
	echo $book->title;
}

Instalace

Knihovnu stáhnete a nainstalujete pomocí nástroje Composer:

composer require nette/database

Podporované databáze

Nette podporuje následující databáze: