# LaravelとDockerを使ったローカル開発環境構築ガイド

## 目次
1. はじめに
2. LaravelとDockerの基礎知識
    1. Laravelとは
    2. Dockerとは
3. 開発環境の準備
    1. 必要なソフトウェアのインストール
    2. Docker Desktopの設定
4. Laravelプロジェクトのセットアップ
    1. プロジェクトの作成
    2. 基本的なディレクトリ構造
5. Dockerの設定
    1. Dockerfileの作成
    2. docker-compose.ymlの設定
6. コンテナの起動と管理
    1. コンテナのビルドと起動
    2. コンテナの確認と操作
7. データベースの設定
    1. MySQLコンテナの利用
    2. Laravel側の設定
8. アプリケーションの開発
    1. 開発用のTinkerの使い方
    2. ホットリロードの設定
9. トラブルシューティング
    1. よくあるエラーとその対処法
10. まとめ

## 1. はじめに
このガイドでは、LaravelとDockerを使用して、効率的なローカル開発環境を構築する方法について詳しく説明します。Dockerはコンテナ技術を利用することで、一貫性のある開発環境を提供します。LaravelはPHPで人気のあるフレームワークで、短期かつ長期間のプロジェクトに適しています。

## 2. LaravelとDockerの基礎知識

### 2-1. Laravelとは
Laravelは、シンプルで表現力豊かな文法を備えたPHPのモダンなフレームワークです。RESTfulなAPI開発やシンプルなWebアプリケーションから、フルスタックアプリケーションに至るまで、さまざまな用途で使用されます。公式サイトではデフォルトで認証、ルーティング、セッションなどが用意されており、開発の効率を高めます。

### 2-2. Dockerとは
Dockerは、コンテナ化技術を用いてアプリケーションを分離された専用の環境で実行するためのツールです。コンテナは非常に軽量で、仮想マシンと比較してリソースを節約できます。Dockerを使用することで、開発環境に応じたパッケージのインストールや設定漏れ等を気にすることなく、複数の開発環境を統一されたコンテナ環境で実現できます。

## 3. 開発環境の準備

### 3-1. 必要なソフトウェアのインストール
- **PHP**: Laravelを動作させるためにはPHPが必要です。バージョンは公式の推奨バージョンを確認し、インストールしてください。
- **Composer**: PHPのパッケージマネージャをインストールします。これを使ってLaravelのプロジェクトを作成します。
- **Docker**: オフィシャルサイトからDocker Desktopをインストールします。

### 3-2. Docker Desktopの設定
Docker Desktopをインストール後、必ずDockerサービスが正しく起動していることを確認してください。また、WindowsやMacを使用している場合は、WSL2やVirtualization Technologyが有効になっているか確認してください。

## 4. Laravelプロジェクトのセットアップ

### 4-1. プロジェクトの作成
Composerを使ってLaravelプロジェクトを新たに作成します。ターミナルで次のコマンドを実行します：
![img](/mosaic-code.jpg)
ここで、`myproject`はプロジェクト名です。

### 4-2. 基本的なディレクトリ構造
作成されたディレクトリ内を確認すると、以下のような構造が一般的です：
![img](/mosaic-code.jpg)
このディレクトリ構造は、Laravelアプリの構成要素をまとめており、MVCパターンが自然に適用されています。

## 5. Dockerの設定

### 5-1. Dockerfileの作成
プロジェクトのルートディレクトリに`Dockerfile`を作成し、次の内容を記述します：
![img](/mosaic-code.jpg)
この設定は、PHPの公式fpmイメージを元に使用し、必要な拡張をインストールし、アプリケーションコードをコピーします。

### 5-2. docker-compose.ymlの設定
`docker-compose.yml`を作成し、以下を記述します：
![img](/mosaic-code.jpg)
このYAMLは、LaravelのアプリケーションとMySQLデータベース、それぞれのコンテナを定義しています。

## 6. コンテナの起動と管理

### 6-1. コンテナのビルドと起動
Dockerコンテナをビルドし、起動するには、プロジェクトのルートディレクトリで次のコマンドを実行します：
![img](/mosaic-code.jpg)
このコマンドで、Dockerfileに基づいたコンテナのビルドと起動が行われ、環境設定が施されます。

### 6-2. コンテナの確認と操作
コンテナのログを確認するには次のコマンドを使用します：
![img](/mosaic-code.jpg)
また、コンテナにアクセスしたいときには以下を利用：  
![img](/mosaic-code.jpg)

## 7. データベースの設定

### 7-1. MySQLコンテナの利用
docker-composeファイルにある通り、MySQLコンテナが既に構成されているため、`docker-compose up` 実行時にデフォルトで起動します。

### 7-2. Laravel側の設定
Laravelの設定でデータベースの接続情報を、`.env`ファイルで以下のように設定します：
![img](/mosaic-code.jpg)
`DB_HOST` をMySQLサービス名 `db` に設定することを忘れないでください。

## 8. アプリケーションの開発

### 8-1. 開発用のTinkerの使い方
Laravel Tinkerは、インタラクティブなシェルで、アプリケーションの各要素を素早くテストするために用います。コンテナ内で以下を実行：
![img](/mosaic-code.jpg)

### 8-2. ホットリロードの設定
Laravelプロジェクト上でホットリロードを行いたい場合、npmを使用してブロックチェーンのモジュールをインストールし、`npm run watch`でWebpackのホットリロードを有効にします。

## 9. トラブルシューティング

### 9-1. よくあるエラーとその対処法
- **Dockerコンテナが起動しない場合**: `docker-compose ps`でステータス確認。エラーログを`docker-compose logs`で調査。
- **.envファイルの設定誤り**: `.env`ファイルの変更後は、再ビルドが必要なため、`docker-compose down`でストップし、アップを行う。

## 10. まとめ
LaravelとDockerを合わせて使用することにより、開発環境の再現性や展開のスピードが向上します。今後もステップに沿い、実際に手を動かして開発に取り組んでみてください。シンプルで強力な実行環境を備え、限られたリソースでも効率的な開発を可能にします。他にも試してみたい構成やツールがあれば、どんどん取り入れて、開発の幅を広げましょう。 [cv:issue_marketplace_engineer]

# LaravelとDockerを使ったローカル開発環境構築ガイド

## 目次
1. はじめに
2. LaravelとDockerの基礎知識
    1. Laravelとは
    2. Dockerとは
3. 開発環境の準備
    1. 必要なソフトウェアのインストール
    2. Docker Desktopの設定
4. Laravelプロジェクトのセットアップ
    1. プロジェクトの作成
    2. 基本的なディレクトリ構造
5. Dockerの設定
    1. Dockerfileの作成
    2. docker-compose.ymlの設定
6. コンテナの起動と管理
    1. コンテナのビルドと起動
    2. コンテナの確認と操作
7. データベースの設定
    1. MySQLコンテナの利用
    2. Laravel側の設定
8. アプリケーションの開発
    1. 開発用のTinkerの使い方
    2. ホットリロードの設定
9. トラブルシューティング
    1. よくあるエラーとその対処法
10. まとめ

## 1. はじめに
このガイドでは、LaravelとDockerを使用して、効率的なローカル開発環境を構築する方法について詳しく説明します。Dockerはコンテナ技術を利用することで、一貫性のある開発環境を提供します。LaravelはPHPで人気のあるフレームワークで、短期かつ長期間のプロジェクトに適しています。

## 2. LaravelとDockerの基礎知識

### 2-1. Laravelとは
Laravelは、シンプルで表現力豊かな文法を備えたPHPのモダンなフレームワークです。RESTfulなAPI開発やシンプルなWebアプリケーションから、フルスタックアプリケーションに至るまで、さまざまな用途で使用されます。公式サイトではデフォルトで認証、ルーティング、セッションなどが用意されており、開発の効率を高めます。

### 2-2. Dockerとは
Dockerは、コンテナ化技術を用いてアプリケーションを分離された専用の環境で実行するためのツールです。コンテナは非常に軽量で、仮想マシンと比較してリソースを節約できます。Dockerを使用することで、開発環境に応じたパッケージのインストールや設定漏れ等を気にすることなく、複数の開発環境を統一されたコンテナ環境で実現できます。

## 3. 開発環境の準備

### 3-1. 必要なソフトウェアのインストール
- **PHP**: Laravelを動作させるためにはPHPが必要です。バージョンは公式の推奨バージョンを確認し、インストールしてください。
- **Composer**: PHPのパッケージマネージャをインストールします。これを使ってLaravelのプロジェクトを作成します。
- **Docker**: オフィシャルサイトからDocker Desktopをインストールします。

### 3-2. Docker Desktopの設定
Docker Desktopをインストール後、必ずDockerサービスが正しく起動していることを確認してください。また、WindowsやMacを使用している場合は、WSL2やVirtualization Technologyが有効になっているか確認してください。

## 4. Laravelプロジェクトのセットアップ

### 4-1. プロジェクトの作成
Composerを使ってLaravelプロジェクトを新たに作成します。ターミナルで次のコマンドを実行します：
```bash
composer create-project --prefer-dist laravel/laravel myproject
```
ここで、`myproject`はプロジェクト名です。

### 4-2. 基本的なディレクトリ構造
作成されたディレクトリ内を確認すると、以下のような構造が一般的です：
```
myproject/
    ├── app/
    ├── bootstrap/
    ├── config/
    ├── database/
    ├── public/
    ├── resources/
    ├── routes/
    ├── storage/
    ├── tests/
    ├── vendor/
    └── .env
```
このディレクトリ構造は、Laravelアプリの構成要素をまとめており、MVCパターンが自然に適用されています。

## 5. Dockerの設定

### 5-1. Dockerfileの作成
プロジェクトのルートディレクトリに`Dockerfile`を作成し、次の内容を記述します：
```dockerfile
FROM php:8.0-fpm

WORKDIR /var/www

RUN apt update && apt install -y \
    git \
    unzip \
    && docker-php-ext-install pdo_mysql

COPY . /var/www

RUN chown -R www-data:www-data /var/www
```
この設定は、PHPの公式fpmイメージを元に使用し、必要な拡張をインストールし、アプリケーションコードをコピーします。

### 5-2. docker-compose.ymlの設定
`docker-compose.yml`を作成し、以下を記述します：
```yaml
version: '3'
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: laravel_app
    ports:
      - "8000:80"
    volumes:
      - .:/var/www
    networks:
      - laravel_network

  db:
    image: mysql:5.7
    container_name: db
    volumes:
      - dbdata:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: laravel
      MYSQL_USER: user
      MYSQL_PASSWORD: secret
    networks:
      - laravel_network

volumes:
  dbdata:

networks:
  laravel_network:
```
このYAMLは、LaravelのアプリケーションとMySQLデータベース、それぞれのコンテナを定義しています。

## 6. コンテナの起動と管理

### 6-1. コンテナのビルドと起動
Dockerコンテナをビルドし、起動するには、プロジェクトのルートディレクトリで次のコマンドを実行します：
```bash
docker-compose up --build
```
このコマンドで、Dockerfileに基づいたコンテナのビルドと起動が行われ、環境設定が施されます。

### 6-2. コンテナの確認と操作
コンテナのログを確認するには次のコマンドを使用します：
```bash
docker-compose logs -f
```
また、コンテナにアクセスしたいときには以下を利用：  
```bash
docker exec -it laravel_app bash
```

## 7. データベースの設定

### 7-1. MySQLコンテナの利用
docker-composeファイルにある通り、MySQLコンテナが既に構成されているため、`docker-compose up` 実行時にデフォルトで起動します。

### 7-2. Laravel側の設定
Laravelの設定でデータベースの接続情報を、`.env`ファイルで以下のように設定します：
```
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=user
DB_PASSWORD=secret
```
`DB_HOST` をMySQLサービス名 `db` に設定することを忘れないでください。

## 8. アプリケーションの開発

### 8-1. 開発用のTinkerの使い方
Laravel Tinkerは、インタラクティブなシェルで、アプリケーションの各要素を素早くテストするために用います。コンテナ内で以下を実行：
```bash
php artisan tinker
```

### 8-2. ホットリロードの設定
Laravelプロジェクト上でホットリロードを行いたい場合、npmを使用してブロックチェーンのモジュールをインストールし、`npm run watch`でWebpackのホットリロードを有効にします。

## 9. トラブルシューティング

### 9-1. よくあるエラーとその対処法
- **Dockerコンテナが起動しない場合**: `docker-compose ps`でステータス確認。エラーログを`docker-compose logs`で調査。
- **.envファイルの設定誤り**: `.env`ファイルの変更後は、再ビルドが必要なため、`docker-compose down`でストップし、アップを行う。

## 10. まとめ
LaravelとDockerを合わせて使用することにより、開発環境の再現性や展開のスピードが向上します。今後もステップに沿い、実際に手を動かして開発に取り組んでみてください。シンプルで強力な実行環境を備え、限られたリソースでも効率的な開発を可能にします。他にも試してみたい構成やツールがあれば、どんどん取り入れて、開発の幅を広げましょう。 [![image](https://firebasestorage.googleapis.com/v0/b/issue-pro-42602.appspot.com/o/topics%2F17fa658b-53c7-4ca0-a28b-e588ed1bd371?alt=media&token=2c00afff-85ff-4428-8d15-696ab676dcb0)](https://i-ssue.com/lp/check_salary)

LaravelとDockerを使ったローカル開発環境構築ガイド

目次

続きを読むには単価診断を受けてください（30秒）