Laravelを使ってWEBアプリケーションを構築する際に、データソースをどうするかが未決定の場合やRDBMSを用意するまでも無い場合にはSQLiteの利用が便利です。

LaravelとSQLiteを用いた開発環境とデータソースを用意する

Laravel を使って WEB アプリケーションを構築する際に、データソースをどうするかが未決定の場合や、RDBMS を用意するまでも無い場合には SQLite が便利です。
今回は、Laravel で SQLite を導入するまでを見ていきます。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#sqlite">SQLite</a></li>
<li><a href="#sqlite-%E3%81%AE%E5%B0%8E%E5%85%A5">SQLite の導入</a></li>
<li><a href="#%E3%83%87%E3%83%BC%E3%82%BF%E3%81%AE%E6%8C%BF%E5%85%A5">データの挿入</a></li>
<li><a href="#%E3%83%87%E3%83%BC%E3%82%BF%E3%81%AE%E7%A2%BA%E8%AA%8D">データの確認</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
今回の開発環境は以下の通りです。
<ul>
<li>Laravel 5.8</li>
</ul>
尚、Laravel のプロジェクトルートを「 laravel/」としています。
<h2 id="sqlite">SQLite</h2>
SQLite（エスキューライト） は、ファイルベースでデータの永続化を行う軽量な SQL データベースエンジンです。
SQLite 
<a href="https://www.sqlite.org" rel="noopener noreferrer" target="_blank">https://www.sqlite.org</a>
データベースサーバなどの用意なく直ぐに使うことが出来る為、とても気軽に使用出来ます。 また、Laravel でも使用可能です。
<h2 id="sqlite-の導入">SQLite の導入</h2>
では Laravel に SQLite を導入していきます。
まず、laravel/database 配下に database.sqlite というファイルを作成します。
<pre><code class="hljs language-shell">laravel/
├── database
│   ├── database.sqlite // ← 作成
</code></pre>
作成したらそれで OK です。
次に、env ファイルへ SQLite を使用する為の記述を行います。
<dl class="description_setting">
<dt>laravel/.env</dt>
<dd>
<pre><code class="hljs language-shell"># DB_CONNECTION=mysql

DB_CONNECTION=sqlite
DB_DATABASE_SQLITE=/path/to/laravel/database/database.sqlite
DB_FOREIGN_KEYS=true
</code></pre>
</dd>
</dl>
<dl>
<dt>DB_CONNECTION</dt>
<dd>デフォルトでは MySQL を使用する記述になっているので、SQLite を使用するように変更します。</dd>
<dt>DB_DATABASE_SQLITE</dt>
<dd>先程作成したファイルのパスを指定（フルパスで指定）します。 ちなみに今回は、後々に MySQL も生かせるようにするのでここの環境変数名を変えています。</dd>
<dt>DB_FOREIGN_KEYS </dt>
<dd>外部キー制約を有効にするかどうかを指定します。ここは必要に応じて指定してください。 次に、設定ファイルを少し変更します。</dd>
<dt></dt>
<dd></dd>
<dt></dt>
<dd></dd>
</dl>
<dl class="description_setting">
<dt>laravel/config/database.php</dt>
<dd>
<pre><code class="hljs language-php">'connections' => [

'sqlite' => [
'driver' => 'sqlite',
 'url' => env('DATABASE_URL'),
 // 環境変数名を変更
 'database' => env('DB_DATABASE_SQLITE', database_path('database.sqlite')),
 'prefix' => '',
 'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
 ],
</code></pre>
</dd>
</dl>
環境変数名を変更した箇所が１つあるので、そこだけ変更します。
と、、これで SQLite の導入は完了です。
<h2 id="データの挿入">データの挿入</h2>
SQLite を使用する準備が整ったので、ここでデータを入れてみます。 今回は Laravel にデフォルトで存在する User モデルを使ってダミーデータを入れます。
以下の artisan コマンドを叩いてシーダクラスを生成します。
<pre><code class="hljs language-shell"># プロジェクトルートへ移動
cd /path/to/laravel

# シーダクラス生成
php artisan make:seeder UsersTableSeeder
</code></pre>
続いて、生成したシーダクラスを定義します。
<dl class="description_setting">
<dt>laravel/database/seeds/UsersTableSeeder.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

use Illuminate\Database\Seeder;

class UsersTableSeeder extends Seeder
{
 public function run()
 {
 factory(App\User::class, 10)->create();
 }
}
</code></pre>
</dd>
</dl>
今回は１０件のデータを生成します。
そしてシーディングの際にこれを実行するように登録します。
<dl class="description_setting">
<dt>laravel/database/seeds/DatabaseSeeder.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
 public function run()
 {
 $this->call(UsersTableSeeder::class);
 }
}
</code></pre>
</dd>
</dl>
デフォルトではご丁寧にも記述済みでコメントアウトされている状態なので、これを外してアクティブにすれば OK です。
最後に、Composer のオートローダを再生成します。
<pre><code class="hljs language-shell"># プロジェクトルートへ移動
cd /path/to/laravel

# オートローダ再生成
composer dump-autoload
</code></pre>
これでデータ挿入の準備は完了です。マイグレーションとシーディングを実行してデータを挿入します。
<pre><code class="hljs language-shell"># プロジェクトルートへ移動
cd /path/to/laravel

# マイグレーション＆シーディング実行
php artisan migrate --seed

# 実行結果
$ php artisan migrate --seed
Migration table created successfully.
Migrating: 2014_10_12_000000_create_users_table
Migrated: 2014_10_12_000000_create_users_table
Migrating: 2014_10_12_100000_create_password_resets_table
Migrated: 2014_10_12_100000_create_password_resets_table
Seeding: UsersTableSeeder
Database seeding completed successfully.
</code></pre>
正常にテーブルの作成とデータの挿入が行われました。
<h2 id="データの確認">データの確認</h2>
先程行ったマイグレーション及びシーディングは、特に意識はしていませんが SQLite へテーブルの作成とデータの挿入が行われています。 簡単にデータ取得を行い確認してみます。
<dl class="description_setting">
<dt>laravel/routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">Route::get('/', function () {
 // 3件だけデータを取得
 $users = App\User::limit(3)->get()->toArray();
 dd($users);
});
</code></pre>
</dd>
</dl>
ブラウザからアクセスしてダンプを表示させてみます。
<pre><code class="hljs language-php">Array
(
 [0] => Array
 (
 [id] => 1
 [name] => Herbert Anderson PhD
 [email] => art.purdy@example.com
 [email_verified_at] => 2019-07-06 09:48:34
 [created_at] => 2019-07-06 09:48:34
 [updated_at] => 2019-07-06 09:48:34
 )

 [1] => Array
 (
 [id] => 2
 [name] => Prof. Raul Bergnaum
 [email] => froob@example.net
 [email_verified_at] => 2019-07-06 09:48:34
 [created_at] => 2019-07-06 09:48:34
 [updated_at] => 2019-07-06 09:48:34
 )

 [2] => Array
 (
 [id] => 3
 [name] => Katheryn Gerhold
 [email] => albina67@example.net
 [email_verified_at] => 2019-07-06 09:48:34
 [created_at] => 2019-07-06 09:48:34
 [updated_at] => 2019-07-06 09:48:34
 )
)
</code></pre>
SQLite へ正常にデータが挿入されている事を確認できました。
また、この時点でデータが空で返ってくる場合は MySQL の方へデータを見に行っている可能性があります。 まずは再度設定を見直し、そこに問題がなかったら、env ファイルのキャッシュのおかげでデータソースの向き先が SQLite に 変更されていない場合があります。その場合は以下の artisan コマンドを叩いてキャッシュを削除してから再度試してみてください。
<pre><code class="hljs language-shell"># プロジェクトルートへ移動
cd /path/to/laravel

# キャッシュの削除
php artisan config:cache
</code></pre>
<h2 id="まとめ">まとめ</h2>
以上で作業は終了です。 SQLite を用いると気軽にデータソースを用意する事ができ、ちょっとした場合に使えて便利です。 また、EloquentORM の使用により DB の種類を意識する事なくデータ操作が行える事も Laravel さまさまですので是非試してみてください。
<a href="https://github.com/rito328/www.ritolab.com-sample-sources-laravel-sqlite" rel="noopener noreferrer" target="_blank">[Github]サンプルコード</a>

Author