Nette Database

A Nette Database egy erőteljes és elegáns adatbázis réteg PHP számára, hangsúlyt fektetve az egyszerűségre és az okos funkciókra. Kétféle módot kínál az adatbázissal való munkára – Explorer az alkalmazások gyors fejlesztéséhez, vagy SQL megközelítés a lekérdezésekkel való közvetlen munkához.

Telepítés

A könyvtárat a Composer eszközzel töltheti le és telepítheti:

composer require nette/database

Támogatott adatbázisok

A Nette Database a következő adatbázisokat támogatja:

Két megközelítés az adatbázishoz

A Nette Database választási lehetőséget kínál: vagy közvetlenül írhat SQL lekérdezéseket (SQL megközelítés), vagy hagyhatja, hogy automatikusan generálódjanak (Explorer). Nézzük meg, hogyan oldják meg mindkét megközelítéssel ugyanazokat a feladatokat:

SQL megközelítés – SQL lekérdezések

// rekord beszúrása
$database->query('INSERT INTO books', [
	'author_id' => $authorId,
	'title' => $bookData->title,
	'published_at' => new DateTime,
]);

// rekordok lekérése: könyvek szerzői
$result = $database->query('
	SELECT authors.*, COUNT(books.id) AS books_count
	FROM authors
	LEFT JOIN books ON authors.id = books.author_id
	WHERE authors.active = 1
	GROUP BY authors.id
');

// listázás (nem optimális, N további lekérdezést generál)
foreach ($result as $author) {
	$books = $database->query('
		SELECT * FROM books
		WHERE author_id = ?
		ORDER BY published_at DESC
	', $author->id);

	echo "Szerző $author->name írt $author->books_count könyvet:\n";

	foreach ($books as $book) {
		echo "- $book->title\n";
	}
}

Explorer megközelítés – automatikus SQL generálás

// rekord beszúrása
$database->table('books')->insert([
	'author_id' => $authorId,
	'title' => $bookData->title,
	'published_at' => new DateTime,
]);

// rekordok lekérése: könyvek szerzői
$authors = $database->table('authors')
	->where('active', 1);

// listázás (automatikusan csak 2 optimalizált lekérdezést generál)
foreach ($authors as $author) {
	$books = $author->related('books')
		->order('published_at DESC');

	echo "Szerző $author->name írt {$books->count()} könyvet:\n";

	foreach ($books as $book) {
		echo "- $book->title\n";
	}
}

Az Explorer megközelítés automatikusan generálja és optimalizálja az SQL lekérdezéseket. A megadott példában az SQL megközelítés N+1 lekérdezést generál (egyet a szerzőkhöz, majd egyet minden szerző könyveihez), míg az Explorer automatikusan optimalizálja a lekérdezéseket, és csak kettőt hajt végre – egyet a szerzőkhöz és egyet az összes könyvükhöz.

Mindkét megközelítés tetszés szerint kombinálható az alkalmazásban, igény szerint.

Csatlakozás és konfiguráció

Az adatbázishoz való csatlakozáshoz elegendő létrehozni egy Nette\Database\Connection osztálypéldányt:

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

A $dsn (data source name) paraméter ugyanaz, amit a PDO használ, pl. host=127.0.0.1;dbname=test. Hiba esetén Nette\Database\ConnectionException kivételt dob.

Azonban egy ügyesebb módszert kínál az alkalmazáskonfiguráció, ahová elegendő hozzáadni egy database szekciót, és létrejönnek a szükséges objektumok, valamint az adatbázis panel a Tracy sávban.

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

Ezután a kapcsolat objektumot szolgáltatásként kapjuk meg a DI konténerből, pl.:

class Model
{
	public function __construct(
		// vagy Nette\Database\Explorer
		private Nette\Database\Connection $database,
	) {
	}
}

További információk az adatbázis konfigurációjáról.

Explorer manuális létrehozása

Ha nem használja a Nette DI konténert, manuálisan is létrehozhat egy Nette\Database\Explorer példányt:

// csatlakozás az adatbázishoz
$connection = new Nette\Database\Connection('mysql:host=127.0.0.1;dbname=mydatabase', 'user', 'password');
// tároló a cache-hez, implementálja a Nette\Caching\Storage-ot, pl.:
$storage = new Nette\Caching\Storages\FileStorage('/path/to/temp/dir');
// gondoskodik az adatbázis struktúra reflexiójáról
$structure = new Nette\Database\Structure($connection, $storage);
// definiálja a táblanevek, oszlopnevek és idegen kulcsok leképezési szabályait
$conventions = new Nette\Database\Conventions\DiscoveredConventions($structure);
$explorer = new Nette\Database\Explorer($connection, $structure, $conventions, $storage);

Kapcsolatkezelés

A Connection objektum létrehozásakor a csatlakozás automatikusan megtörténik. Ha késleltetni szeretné a csatlakozást, használja a lazy módot – ezt a konfigurációban a lazy beállításával, vagy így kapcsolhatja be:

$database = new Nette\Database\Connection($dsn, $user, $password, ['lazy' => true]);

A kapcsolat kezeléséhez használja a connect(), disconnect() és reconnect() metódusokat.

• connect() létrehozza a kapcsolatot, ha még nem létezik, és Nette\Database\ConnectionException kivételt dobhat.
• disconnect() megszakítja az aktuális adatbázis-kapcsolatot.
• reconnect() megszakítja, majd újra csatlakoztatja az adatbázishoz. Ez a metódus szintén Nette\Database\ConnectionException kivételt dobhat.

Ezenkívül figyelheti a csatlakozással kapcsolatos eseményeket az onConnect esemény segítségével, amely egy callback tömb, amely az adatbázissal való kapcsolat létrejötte után hívódik meg.

// az adatbázishoz való csatlakozás után fut le
$database->onConnect[] = function($database) {
	echo "Csatlakozva az adatbázishoz";
};

Tracy Debug Bar

Ha Tracy-t használ, a Database panel automatikusan aktiválódik a Debug sávban, amely megjeleníti az összes végrehajtott lekérdezést, azok paramétereit, végrehajtási idejét és a kódban való meghívásuk helyét.