База данни Nette

Nette Database е мощен и елегантен слой за бази данни за PHP с акцент върху простотата и интелигентните функции. Той предлага два допълващи се начина за работа с вашите данни – с помощта на Изследователя за бърза разработка или с помощта на SQL за пълен контрол върху заявките.

Инсталация

Можете да изтеглите и инсталирате библиотеката, като използвате Composer:

composer require nette/database

Поддържани бази данни

Nette Database поддържа следните бази данни:

Два подхода за работа с бази данни

С Nette Database можете да пишете SQL заявки директно (SQL начин) или да оставите SQL да се генерира автоматично (Explorer начин). Нека видим как двата подхода решават едни и същи задачи:

SQL начин – писане на SQL заявки

// Вмъкване на запис
$database->query('INSERT INTO books', [
	'author_id' => $authorId,
	'title' => $bookData->title,
	'published_at' => new DateTime,
]);

// Извличане на записи: автори на книги
$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
');

// Показване (не е оптимално, генерира N допълнителни заявки)
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";
	}
}

Начин на Explorer – автоматично генериране на SQL

// Вмъкване на запис
$database->table('books')->insert([
	'author_id' => $authorId,
	'title' => $bookData->title,
	'published_at' => new DateTime,
]);

// Извличане на записи: автори на книги
$authors = $database->table('authors')
	->where('active', 1);

// Показване (автоматично генерира само 2 оптимизирани заявки)
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";
	}
}

Подходът на Explorer генерира и оптимизира SQL заявките автоматично. В примера по-горе примерът за начин на SQL генерира N+1 заявки (една за авторите и една за книгите на всеки автор), докато Изследователят извършва само две оптимизирани заявки – една за авторите и друга за всички техни книги.

Можете свободно да комбинирате двата подхода в приложението си според нуждите.

Свързване и конфигуриране

За да се свържете с базата данни, просто създайте инстанция на класа Nette\Database\Connection:

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

Параметърът $dsn (име на източника на данни) следва същия формат, който използва PDO, например host=127.0.0.1;dbname=test. Ако връзката се провали, се изхвърля Nette\Database\ConnectionException.

По-удобен метод обаче е да се използва конфигурацията на приложението. Добавете раздел database и необходимите обекти ще бъдат създадени, включително панел за база данни в лентата за отстраняване на грешки на Tracy.

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

След това обектът за връзка може да бъде изтеглен като услуга от контейнера DI, напр:

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

За повече информация вижте Конфигурация на базата данни.

Ръчно създаване на Explorer

Ако не използвате контейнера Nette DI, можете ръчно да създадете инстанция на 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);

Управление на връзките

Когато създавате обект Connection, той се свързва автоматично с базата данни. Ако искате да забавите свързването, разрешете мързеливия режим в конфигурацията, като зададете lazy, или го направете по следния начин:

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

За да управлявате връзката, използвайте методите connect(), disconnect() и reconnect().

• Методът connect() установява връзка, ако тя още не е установена, и може да хвърли Nette\Database\ConnectionException.
• disconnect() прекъсва връзката с базата данни.
• reconnect() прекъсва връзката и след това се свързва отново с базата данни, като може да хвърли и Nette\Database\ConnectionException.

Освен това можете да наблюдавате събитията, свързани с връзката, като използвате събитието onConnect, което представлява масив от обратни извиквания, изпълнявани след свързване с базата данни.

// Извикване след свързване с базата данни
$database->onConnect[] = function($database) {
	echo "Connected to the database";
};

Лентата за отстраняване на грешки на Tracy

Ако използвате Tracy, панелът Database (База данни) в лентата за отстраняване на грешки се активира автоматично. В него се показват всички изпълнени заявки, техните параметри, времето на изпълнение и мястото в кода, където са били извикани.