> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# データベース設定
> Laravelのデータベース接続設定、read/write分離、複数接続、SQL実行、クエリリスニング、transactionの基本を解説します。
## はじめに
Laravelは次のデータベースを公式にサポートしています。
* MySQL / MariaDB
* PostgreSQL
* SQLite
* SQL Server
あなたは生SQL、Query Builder、Eloquent ORMのどれでも同じ接続設定を使えます。
このページはデータベース接続の前提を扱います。実践的なクエリは[Query Builder](/jp/query-builder)、スキーマ管理は[Migrations](/jp/migrations)、初期データ投入は[Seeding](/jp/seeding)を参照してください。
## 設定
データベース設定は `config/database.php` に集約されています。
あなたは `default` で既定の接続名を選び、`connections` で接続ごとの詳細を定義します。
```mermaid theme={null}
flowchart TD
A[".env"] --> B["config/database.php"]
B --> C["default connection"]
B --> D["connections.mysql"]
B --> E["connections.pgsql"]
B --> F["connections.sqlite"]
C --> G["DB facade / Query Builder / Eloquent"]
```
```php theme={null}
// config/database.php
'default' => env('DB_CONNECTION', 'sqlite'),
'connections' => [
'mysql' => [
'driver' => 'mysql',
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'laravel'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
],
],
```
`.env` では少なくとも次を設定してください。
```ini theme={null}
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=app
DB_USERNAME=app_user
DB_PASSWORD=secret
```
SQLiteを使う場合は `DB_CONNECTION=sqlite` と `DB_DATABASE` のパスを設定します。
## 読み取り・書き込み接続の分離
読み取り(`SELECT`)と書き込み(`INSERT` / `UPDATE` / `DELETE`)を別ホストに分離したい場合、同じ接続内で `read` と `write` を設定してください。
```php theme={null}
'mysql' => [
'driver' => 'mysql',
'read' => [
'host' => ['10.0.0.10', '10.0.0.11'],
],
'write' => [
'host' => ['10.0.0.20'],
],
'sticky' => true,
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'laravel'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
],
```
`sticky` を `true` にすると、同一リクエスト内で書き込み後の読み取りがwrite接続に固定されます。
レプリカ遅延がある構成では `sticky` を有効にすると、書き込み直後に古いデータを読むリスクを下げられます。
## 複数データベース接続
あなたは `config/database.php` に接続を複数定義し、`DB::connection()` で切り替えられます。
```php theme={null}
use Illuminate\Support\Facades\DB;
$users = DB::connection('sqlite')->select('select * from users');
$pdo = DB::connection('pgsql')->getPdo();
```
```mermaid theme={null}
flowchart LR
A["DB::connection('mysql')"] --> B["Primary DB"]
C["DB::connection('pgsql')"] --> D["Analytics DB"]
E["DB::connection('sqlite')"] --> F["Local file DB"]
```
## SQLクエリの実行
`DB` facadeはクエリ種別ごとに専用メソッドを持ちます。
```php theme={null}
use Illuminate\Support\Facades\DB;
$users = DB::select('select * from users where active = ?', [1]);
DB::insert('insert into users (name, email) values (?, ?)', ['Taylor', 'taylor@example.com']);
$affected = DB::update('update users set votes = 100 where name = ?', ['Taylor']);
$deleted = DB::delete('delete from sessions where user_id = ?', [1]);
DB::statement('drop table temporary_imports');
```
ユーザー入力をSQL文字列に直接連結しないでください。必ずバインディング引数を使ってSQL injectionを防いでください。
## クエリリスニング
実行されたSQLを追跡したいときは、Service Providerの `boot()` で `DB::listen()` を登録してください。
```php theme={null}
use Illuminate\Database\Events\QueryExecuted;
use Illuminate\Support\Facades\DB;
public function boot(): void
{
DB::listen(function (QueryExecuted $query) {
logger()->debug('SQL executed', [
'sql' => $query->toRawSql(),
'time_ms' => $query->time,
]);
});
}
```
## transaction
複数の更新を1つの単位として扱うなら `DB::transaction()` を使ってください。
例外が発生するとLaravelが自動でロールバックします。
```php theme={null}
use Illuminate\Support\Facades\DB;
DB::transaction(function () {
DB::update('update users set votes = 1');
DB::delete('delete from posts where archived = 1');
});
```
デッドロック再試行が必要なら `attempts` を指定できます。
```php theme={null}
DB::transaction(function () {
// ...
}, attempts: 5);
```
手動で制御したい場合は `beginTransaction` / `rollBack` / `commit` を使ってください。
```php theme={null}
DB::beginTransaction();
try {
DB::update('update accounts set balance = balance - 100 where id = ?', [1]);
DB::update('update accounts set balance = balance + 100 where id = ?', [2]);
DB::commit();
} catch (\Throwable $e) {
DB::rollBack();
throw $e;
}
```
## 次のステップ
接続設定を使って安全にクエリを組み立てる方法を学びます。
接続したデータベースのスキーマをバージョン管理する方法を学びます。
開発・テスト用データを再現可能な形で投入する方法を学びます。