Laravelのデータベース設定方法を完全ガイド！初心者でもわかる.envファイルの使い方
生徒
「Laravelでデータベースを使いたいんですが、どうやって設定するんですか？」
先生
「Laravelでは、.env（ドットエヌブイ）ファイルを使って、データベースの接続情報を設定しますよ。」
生徒
「その.envファイルってどこにあるんですか？どうやって書けばいいんですか？」
先生
「それでは、基本からしっかり説明していきましょう！」
1. Laravelでデータベースを使う準備とは？
Laravel（ララベル）では、MySQL（マイエスキューエル）などのデータベースと接続して、データを読み書きできます。これにより、会員登録フォームで入力されたユーザー情報を保存したり、商品データを一覧表示したりといった「動きのあるWebアプリ」を作ることができます。
ただし、いきなりプログラムを書き始めても、Laravelが「どのデータベースに接続すればよいか」を知らないと、データは保存できません。そこでまず、Laravelプロジェクトとデータベースを正しくつなぐためのデータベース設定を行う必要があります。
初心者向けイメージ：データベースにつながっていると何がうれしい？
たとえば、会員登録フォームから送られた名前やメールアドレスを、LaravelからMySQLに保存するイメージは次のような感じです。
// 例：会員情報をデータベースに保存するイメージコード
$user = new User();
$user->name = '山田太郎';
$user->email = 'taro@example.com';
$user->save(); // ← MySQLのテーブルに保存される
このような「データを保存する処理」がきちんと動くためには、あらかじめLaravelとMySQLの接続情報を設定しておくことが大事です。
この「Laravelとデータベースをつなぐための情報」をまとめて書いておく場所が、プロジェクトルートにある.envファイルです。次の章から、この.envファイルにどのような項目を書いていくのか、少しずつ確認していきましょう。
2. .envファイルとは？
.envファイルは、Laravelのプロジェクトルート（最上部のフォルダ）にあるとても大事な設定ファイルで、「ドット・エヌ・ブイ」と読みます。Laravelアプリが「今はどんな環境で動いているのか」「どのデータベースに接続するのか」といった情報を、この1枚のメモにまとめておくイメージです。
ここに書かれているのは、データベースやメールサーバー、アプリの名前などの「環境ごとの設定値」です。開発用パソコン、本番サーバーなど、場所によって設定を変えたいときに、.envファイルを書き換えるだけで切り替えられるので、Laravelの運用がとても楽になります。
初心者向けイメージ：.envファイルは「アプリ用の設定メモ帳」
プログラミング未経験の方は、.envファイルを「アプリ専用のメモ帳」と考えるとわかりやすいです。たとえば、次のような行が並んでいます。
APP_NAME=Laravelアプリ
APP_ENV=local
APP_DEBUG=true
左側が項目名（キー）、右側がその値です。APP_ENV=local を APP_ENV=production のように変えると、「今は本番用の環境だよ」とLaravelに伝えることができます。データベース接続やメール設定も同じように、この.envファイルに書き込んでいきます。
また、パスワードやAPIキーのような機密情報もこの.envファイルに書いておき、GitHubなどには公開しないのがLaravelの基本的な運用ルールです。このおかげで、パソコンごと・サーバーごとに違う設定を安全に管理できるようになっています。次の章では、この.envファイルの中に書くデータベース接続情報の具体例を見ていきましょう。
3. データベース接続情報の記述方法
実際にLaravelからMySQLへつなぐためには、.envファイルに「どのデータベースに接続するのか」を細かく書いてあげる必要があります。ここで設定した内容をもとに、Laravelがユーザー情報や商品データを読み書きできるようになります。
LaravelでMySQLを使う場合、.envファイルには次のような設定を書きます。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=secret
それぞれの項目の意味は以下の通りです。プログラミング未経験の方でもイメージしやすいように、できるだけかみ砕いて説明します。
- DB_CONNECTION：どの種類のデータベースを使うかを指定します。MySQLを使うときは
mysqlと書きます。もし別のデータベースを使う場合は、ここが変わることがあります。 - DB_HOST：データベースが動いている場所（住所）のことです。自分のパソコンでXAMPPを使っている場合は、基本的に
127.0.0.1（自分自身）で問題ありません。 - DB_PORT：データベースにアクセスするための入口番号です。MySQLの標準（デフォルト）は
3306なので、特別な設定をしていなければそのままで大丈夫です。 - DB_DATABASE：接続したいデータベースの名前です。後の手順で作成する「laravel_db」など、phpMyAdminで作ったデータベース名をここに書きます。
- DB_USERNAME：データベースにログインするときのユーザー名です。XAMPPの初期設定では
rootになっていることが多いです。 - DB_PASSWORD：上記ユーザーのパスワードです。XAMPPの初期状態では空欄のこともありますが、セキュリティのためにパスワードを設定した場合は、その値をここに書きます。ここでは例として
secretと書いています。
初心者向けサンプル：自分の環境用に書き換えたイメージ
たとえば、XAMPPで「laravel_app_db」という名前のデータベースを作り、パスワードを「mypassword」にした場合、.envファイルの一部は次のようになります。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_app_db
DB_USERNAME=root
DB_PASSWORD=mypassword
このように、自分が作成したデータベース名やユーザー情報に合わせて書き換えるだけで、LaravelとMySQLが正しくつながるようになります。難しいことをしているように見えますが、実際は「どこに・どの名前で・誰として・どんな鍵で入るか」をメモしているだけ、と考えると理解しやすくなります。
4. データベースを作成する方法（XAMPPの場合）
Laravelをローカル環境で動かすときは、XAMPP（ザンプ）というソフトを使って、MySQLを立ち上げるのが一般的です。
以下の手順でデータベースを作成します：
- XAMPPを起動して「MySQL」をStart
- ブラウザで
http://localhost/phpmyadminを開く - 「データベース」タブをクリック
- 名前を「laravel_db」などにして「作成」
これで.envファイルに書いたDB_DATABASE=laravel_dbと一致させることができます。
5. 設定を反映するにはキャッシュをクリア
.envファイルを変更したあと、Laravelはすぐに新しい情報を読み込まないことがあります。その場合はキャッシュを削除します。
以下のコマンドをターミナル（黒い画面）で実行しましょう。
php artisan config:cache
この操作で、Laravelは最新の.envの設定を読み込み直してくれます。
6. .envファイルはバージョン管理に含めない
.envファイルにはパスワードなどの機密情報が書かれているため、Gitなどでコードを共有するときには含めないようにします。
Laravelでは、最初から.gitignoreというファイルに.envが除外されるようになっているので安心です。
まとめ
Laravelでデータベースを扱う最初のステップとして、今回学んだ.envファイルの設定方法は非常に重要な基盤となります。Laravelは複雑な処理を自動化してくれる便利なフレームワークですが、その内部で動作するデータベース接続は正しく設定しなければアプリケーション全体がうまく動きません。データベースはユーザー情報や商品データ、投稿内容などを管理する中心的な存在であり、設定を理解することでLaravel開発の幅が一気に広がります。.envファイルを使うことで、開発環境と本番環境で異なる情報を簡単に切り替えることができ、安全でわかりやすい設定管理が可能になります。特にデータベース接続情報は、アプリケーションの安定した動作に欠かせないため、HOSTやPORT、USERNAMEなどの値がどのように使われるのかを理解しておくことで、後々のトラブルを未然に防ぐことにもつながります。MySQLを利用する環境であればXAMPPやMAMPを使ったローカル環境の構築が必要であり、その手順を覚えることはLaravelを扱う上で確実に役立ちます。phpMyAdminを使ったデータベース作成は初心者でも直感的に扱えるので、LaravelとMySQLを組み合わせた開発では頻繁に使用することになります。 さらに、Laravelが内部で設定情報をキャッシュする仕組みを持っているため、.envを変更した後にはconfigキャッシュをクリアする操作が必要になります。この動作を理解しておくことで、設定変更が反映されない場合でも慌てずに対応できるようになります。また、機密情報が記載された.envファイルをGitで共有してはいけない理由や、そのためにLaravelプロジェクトには最初から.gitignoreで.envが除外される設定がされている点も、初学者にとって押さえておきたいポイントです。今回の内容をしっかり理解しておくと、今後データベースを使ったユーザー管理、商品管理、ログイン機能の実装、さらに高度なクエリの実行やEloquent ORMを使った開発へとスムーズに進むことができるでしょう。Laravelはデータベースと密接に連携して動くフレームワークのため、設定を正しく行えることは開発者としての自信にもつながり、複数人での開発や本番環境へのデプロイなど幅広い場面で強みを発揮します。 今回の学びを通して、Laravelがどれほど柔軟で扱いやすい仕組みを持つフレームワークであるかを実感できたはずです。特に.envファイルの編集は一見単純な作業ですが、アプリケーションの動作に直結する重要な役割を果たしており、ここを理解しているだけでトラブルシューティングの精度が大きく向上します。開発環境を整える経験は、今後さらに学習を進める上で深い理解につながり、Laravelでの開発がより楽しく、より自由度の高いものへと変わっていくはずです。何度も見返しながら、自分のペースで設定作業を進めることで、自然とデータベース設定に自信がついていきます。このまとめを通じて、Laravelでの開発の可能性をさらに広げるきっかけになればうれしく思います。
サンプル設定コードのおさらい
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=secret
この設定を正しく記述することで、Laravelはデータベースとスムーズにつながり、必要な情報を保存したり読み込んだりできるようになります。特にDB_HOSTやDB_DATABASEの指定は、設定ミスが起こりやすいため、開発時には丁寧に確認しながら進めると安心です。
生徒
「.envファイルがこんなに大事だとは知りませんでした。これでデータベースとの接続ができるようになって安心しました！」
先生
「そうですね。.envはLaravelの設定の中心であり、特にデータベース設定では必ず触れる部分なので、今日理解できたのは大きな前進ですよ。」
生徒
「phpMyAdminでデータベースを作って、それを.envに書くという流れもわかりやすかったです。設定が反映されない理由もキャッシュが原因だと知って納得しました。」
先生
「その理解はとても素晴らしいです。Laravelは便利な反面、自動化されている部分も多いので、キャッシュの存在に気づけることは開発者として大きな成長になりますよ。」
生徒
「これからデータを保存したり一覧表示したりする機能を作るのが楽しみになりました！」
先生
「その意欲があれば大丈夫です。Laravelは学ぶほど便利さが実感できるので、次はモデルやマイグレーションにも挑戦してみましょう。」
この記事を読んだ人からの質問
