Podatkovna zbirka Nette

Nette Database je zmogljiv in eleganten sloj podatkovne zbirke za PHP, ki se osredotoča na preprostost in pametne funkcije. Ponuja dva dopolnjujoča se načina dela s podatki – z uporabo Raziskovalca za hiter razvoj ali na način SQL za popoln nadzor nad poizvedbami.

Namestitev

Knjižnico lahko prenesete in namestite s programom Composer:

composer require nette/database

Podprte zbirke podatkov

Podatkovna baza Nette podpira naslednje podatkovne baze:

Dva pristopa k delu s podatkovno bazo

V podatkovni zbirki Nette lahko poizvedbe SQL pišete neposredno (način SQL) ali pustite, da se SQL generira samodejno (način Explorer). Oglejmo si, kako oba pristopa rešujeta iste naloge:

Način SQL – pisanje poizvedb SQL

// Vstavljanje zapisa
$database->query('INSERT INTO books', [
	'author_id' => $authorId,
	'title' => $bookData->title,
	'published_at' => new DateTime,
]);

// Pridobivanje zapisov: avtorji knjig
$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
');

// Prikaz (ni optimalno, ustvarja N dodatnih poizvedb)
foreach ($result as $author) {
	$books = $database->query('
		SELECT * FROM books
		WHERE author_id = ?
		ORDER BY published_at DESC
	', $author->id);

	echo "Author $author->name has written $author->books_count books:\n";

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

Raziskovalni način – Samodejno generiranje SQL

// Vstavljanje zapisa
$database->table('books')->insert([
	'author_id' => $authorId,
	'title' => $bookData->title,
	'published_at' => new DateTime,
]);

// Pridobivanje zapisov: avtorji knjig
$authors = $database->table('authors')
	->where('active', 1);

// Prikaz (samodejno ustvari le 2 optimizirani poizvedbi)
foreach ($authors as $author) {
	$books = $author->related('books')
		->order('published_at DESC');

	echo "Author $author->name has written {$books->count()} books:\n";

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

Pristop Raziskovalec samodejno generira in optimizira poizvedbe SQL. V zgornjem primeru zgled načina SQL ustvari N+1 poizvedb (eno za avtorje in eno za knjige vsakega avtorja), medtem ko Raziskovalec izvede le dve optimizirani poizvedbi – eno za avtorje in drugo za vse njihove knjige.

Oba pristopa lahko po potrebi poljubno kombinirate v svoji aplikaciji.

Povezava in konfiguracija

Če se želite povezati s podatkovno zbirko, preprosto ustvarite primerek razreda Nette\Database\Connection:

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

Parameter $dsn (ime vira podatkov) ima enako obliko, kot jo uporablja PDO, npr. host=127.0.0.1;dbname=test. Če povezava ne uspe, se vrže razred Nette\Database\ConnectionException.

Vendar je priročnejša metoda uporaba konfiguracije aplikacije. Dodajte razdelek database in ustvarjeni bodo potrebni objekti, vključno s ploščo podatkovne zbirke v Tracy Debug Bar.

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

Po tem lahko objekt povezave pridobite kot storitev iz vsebnika DI, npr:

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

Za več informacij glejte Konfiguracija podatkovne baze.

Ročno ustvarjanje Raziskovalca

Če ne uporabljate vsebnika Nette DI, lahko ročno ustvarite primerek Nette\Database\Explorer:

// database connection
$connection = new Nette\Database\Connection('mysql:host=127.0.0.1;dbname=mydatabase', 'user', 'password');
// cache storage, implements Nette\Caching\Storage, e.g.:
$storage = new Nette\Caching\Storages\FileStorage('/path/to/temp/dir');
// handles database structure reflection
$structure = new Nette\Database\Structure($connection, $storage);
// defines rules for mapping table names, columns, and foreign keys
$conventions = new Nette\Database\Conventions\DiscoveredConventions($structure);
$explorer = new Nette\Database\Explorer($connection, $structure, $conventions, $storage);

Upravljanje povezav

Ko ustvarite objekt Connection, se ta samodejno poveže s podatkovno bazo. Če želite povezavo odložiti, v konfiguraciji omogočite leni način z nastavitvijo lazy, ali pa to storite na naslednji način:

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

Za upravljanje povezave uporabite metode connect(), disconnect() in reconnect().

• connect() vzpostavi povezavo, če še ni bila vzpostavljena, in lahko vrže metodo Nette\Database\ConnectionException.
• disconnect() prekine povezavo s podatkovno zbirko.
• reconnect() prekine povezavo in se nato ponovno poveže s podatkovno zbirko, pri čemer lahko vrže tudi Nette\Database\ConnectionException.

Poleg tega lahko spremljate dogodke povezave z uporabo dogodka onConnect, ki je niz povratnih klicev, izvedenih po vzpostavitvi povezave s podatkovno bazo.

// se pokliče po vzpostavitvi povezave s podatkovno bazo
$database->onConnect[] = function($database) {
	echo "Connected to the database";
};

Tracy Debug Bar

Če uporabljate program Tracy, je plošča Podatkovna baza v vrstici za odpravljanje napak samodejno omogočena. Na njej so prikazane vse izvedene poizvedbe, njihovi parametri, čas izvedbe in mesto v kodi, kjer so bile poklicane.