База данных 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";
	}
}

Путь проводника – автоматическая генерация 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 запрос (один для авторов и один для книг каждого автора), в то время как Explorer выполняет только два оптимизированных запроса – один для авторов и другой для всех их книг.

Вы можете свободно комбинировать оба подхода в своем приложении по мере необходимости.

Подключение и конфигурация

Чтобы подключиться к базе данных, просто создайте экземпляр класса 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,
	) {
	}
}

Дополнительные сведения см. в разделе Конфигурация базы данных.

Создание проводника вручную

Если вы не используете контейнер 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, панель Database в Debug Bar включается автоматически. На ней отображаются все выполненные запросы, их параметры, время выполнения и место в коде, где они были вызваны.