環境
- windows10
- DockerDesktop for Win 3.5.x
- Laravel 8.x
- PHP 8.x
- Nginx 2.x
- MySQL 8.x
- VsCode
- gitbash 2.32.0.1
目的
Dockerを使用してLaravelアプリ(特に転職時のポートフォリオ)を効率的に開発するということに着目して解説していきます。
未経験からエンジニア転職活動においては、ポートフォリオの作成は必須です。
プログラミング学習をする際は、常にポートフォリオの完成という第一目標を意識してそこから逆算して開発を行うことにより、最短で転職することができると思います。
※私自身も細かいところまでは正確に理解していません。(より効率的なコードの記述方法などがあるかもしれません。)
全体像
手順(概要)
- Dockerのデスクトップアプリをダウンロード
- Docker.appを起動
- ディレクトリ・設定ファイル準備
- Dockerイメージをビルド
- Dockerコンテナを起動
- Laravelでプロジェクト作成
- DBと接続
- Jetstreamを導入する
ディレクトリ構造
※2021/9/3～laravel-portfolioからmy-appに名称変更しています。
手順(詳細)
※事前準備としてgitのインストールを完了しておいてください。(Macの方は以下の記事が参考になるかもしれません)
Dockerのデスクトップアプリをダウンロード
https://www.docker.com/products/docker-desktop
Intel製CPU版とM1版があるので、お使いの端末に応じてダウンロードしてください
Docker.appを起動
ディレクトリ・設定ファイル準備
githubに公開していますので、以下コマンドでcloneしていただくか、一からディレクトリとファイルを作成してをコードを書き写していただても構いません。
git clone https://github.com/masayan1126/docker-laravel.gitホスト側(Mac、Windowsなど)のプロジェクトルートディレクトリ(docker-compose.ymlがある場所)に.envを作成し、以下のように記述してください。
.env
IP=127.0.0.1Dockerイメージをビルド
docker-compose.ymlファイルがあるディレクトリと同じ階層でbuildコマンドを実行します。
docker-compose buildこれにより、image(コンテナの元になる要素)を構築します。(まだコンテナは作成されません)
イメージはdocker-compose.ymlファイルに定義されている内容及びDockerfileを参考にして構築します。
Dockerコンテナを起動
ビルドしたイメージを元にコンテナを作成して、起動します。オプションで-dをつけることでバックグラウンドで実行することが一般的です。
docker-compose up -dまた、オプションで–buildをつけることで起動前にイメージも構築します。
upコマンドでは、キャッシュがある場合はそれを使って一発でイメージの構築から、コンテナの構築・起動までします。imageがなくてもbuildから実行してくれます。（ build コマンドと同じでDockerfileを更新してても反映されません。）
キャッシュがない場合は –build オプションをつけることで、イメージの構築から、コンテナの構築・起動までしてくれます。
新しいサービスを初めて立ち上げる場合は基本期にはキャッシュはないので docker-compose up –build コマンドを使いましょう
Dockerコマンド一覧
| イメージ構築 | コンテナ構築 | コンテナ起動 | |
|---|---|---|---|
| build | ○ | × | × |
| up | △ | ○ | ○ |
| start | × | × | ○ |
| run | ○ （単独） | ○ （単独） | ○ （単独） |
Laravelプロジェクト作成
ここまでで、サーバーの構築が完了したので、laravelプロジェクトを作成していきます。
phpコンテナに入る
ホストOSから以下のコマンドをターミナルで実行することで、phpコンテナ(アプリケーションサーバー)へ入ることができます
docker-compose exec app bashlaravelのプロジェクトを作成する
コンテナ内(root@～:/var/www#)でターミナルから以下コマンドを実行すると、laravelプロジェクトのベースを作成することができます。
composer create-project laravel/laravel my-appブラウザからhttp://localhost:8000/へアクセスし、Laravelのトップ画面が確認できれば成功です。
DBと接続
続いて、MySQLサーバーとの接続を行います
ワーキングディレクトリに移動
phpコンテナ内(root@～:/var/www#)でターミナルから以下コマンドを実行し、プロジェクトのワーキングディレクトリに移動します
cd laravel-portfolio.envファイルを修正
laravelでは.envファイルにデータベースとの接続設定を記載する必要があるため、下記の内容を修正します。(ホスト名、DB名、password)
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=↓
DB_CONNECTION=mysql
# mysqlコンテナのサービス名(✖︎container_name)
DB_HOST=db
DB_PORT=3306
# ymlファイルのMYSQL_DATABASEと合わせる
DB_DATABASE=test_db
DB_USERNAME=root
DB_PASSWORD=rootJetstreamを導入する
上記迄の手順までだけでも良いのですが、認証管理や、Apiの構築機能も大抵の場合必要になってきますので、Jetstreamを用いてそれらを構築していきます。
Jetstreamはログイン、新規登録、メール検証、2段階認証、セッション管理、APIサポート(Laravel Sanctum)などの機能を提供してくれる優れものです。また、フロントエンドにはとても注目されているTailwind CSSというCSSフレームワークを使用しており、一気にモダンなアプリケーションに仕上げることができます。
jetstream(inertia)のインストール・テーブルのマイグレーション・フロントエンドビルドを一気に実行
composer require laravel/jetstream && php artisan jetstream:install inertia && php artisan migrate && npm install && npm run dev※以下のようなエラー(「そのようなファイルまたはディレクトはありません」)が生じた場合は、
一旦jetstreamを削除(composer remove laravel/jetstream)してもう一度installしてみてください。
require(/var/www/laravel-portfolio/vendor/laravel/jetstream/src/../routes/.php): Failed to open stream: No such file or directory最後にキャッシュを再作成して完了です。
php artisan config:cache && php artisan route:cacheブラウザからhttp://localhost:8000/へアクセスし、Laravelのトップ画面右上に「Login」「Register」のメニューが表示されていれば成功です。
最後に
最後まで本記事を読んでくださり、ありがとうございました。
Dockerを用いることでかなりの速さで環境構築を行うことができます。また、ポートフォリオには可能な限りモダンな技術を使用する方が企業にも好印象を持たれる可能性が高いので、ぜひこちらの記事を参考にポートフォリオ作成に取り組んでいただければと思います。
別の記事で、本記事で構築した環境を元に実際にアプリの開発方法を紹介していければと思います。
Laravel学習におすすめの書籍
![PHPフレームワーク Laravel Webアプリケーション開発 バージョン8.x対応 [ 竹澤 有貴 ]](https://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/3002/9784802613002.jpg?_ex=128x128)
PHP学習におすすめの書籍
![独習PHP 第4版 [ 山田 祥寛 ]](https://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/8494/9784798168494_1_11.jpg?_ex=128x128)
Nginx学習におすすめの書籍
![nginx実践入門 （WEB＋DB press plusシリーズ） [ 久保達彦 ]](https://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/8660/9784774178660.jpg?_ex=128x128)
MySQL学習におすすめの書籍
![MySQL徹底入門 第4版 MySQL 8.0対応 [ yoku0825 ]](https://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1488/9784798161488.jpg?_ex=128x128)
コメント