Nette Database

Nette Databaseは、シンプルさとスマートな機能に重点を置いた、PHP向けの強力でエレガントなデータベース層です。データベースを操作する2つの方法を提供します – アプリケーションの迅速な開発のためのExplorer、またはクエリを直接操作するためのSQLアクセス。

インストール

ライブラリはComposerツールを使用してダウンロードおよびインストールします：

composer require nette/database 

サポートされているデータベース

Nette Databaseは以下のデータベースをサポートしています：

データベースへの2つのアプローチ

Nette Databaseは選択肢を提供します：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->name は $author->books_count 冊の本を書きました:\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->name は {$books->count()} 冊の本を書きました:\n";	foreach ($books as $book) {	echo "- $book->title\n";	} } 

ExplorerアクセスはSQLクエリを自動的に生成および最適化します。上記の例では、SQLアクセスはN+1個のクエリ（著者用に1つ、各著者の本用に1つ）を生成しますが、Explorerはクエリを自動的に最適化し、2つだけ実行します – 著者用に1つ、すべての本用に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(	// または Nette\Database\Explorer	private Nette\Database\Connection $database,	) {	} } 

データベース設定の詳細については、こちらをご覧ください。

Explorerの手動作成

Nette DIコンテナを使用しない場合は、Nette\Database\Explorerインスタンスを手動で作成できます：

// データベースへの接続 $connection = new Nette\Database\Connection('mysql:host=127.0.0.1;dbname=mydatabase', 'user', 'password'); // キャッシュ用ストレージ、Nette\Caching\Storage を実装、例： $storage = new Nette\Caching\Storages\FileStorage('/path/to/temp/dir'); // データベース構造のリフレクションを担当 $structure = new Nette\Database\Structure($connection, $storage); // テーブル名、カラム名、外部キーのマッピングルールを定義 $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 "データベースに接続しました"; }; 

Tracyデバッグバー

Tracyを使用している場合、デバッグバーにデータベースパネルが自動的にアクティブになり、実行されたすべてのクエリ、そのパラメータ、実行時間、およびコード内で呼び出された場所が表示されます。