## 1.プロジェクトの概要

#### 1. プロジェクト名

README プロジェクト

#### プロジェクトの目的

分かりやすい README の作成方法をマークダウン記法お伝えするプロジェクト

#### プロジェクト体制

- 開発メンバー:5 名
- プロジェクトリーダー:onumaro
- バックエンド担当:onumaro
- フロントエンド担当:onumaro
- 開発設計担当:onumaro
- デザイン:onumaro
- その他付随する業務:onumaro

#### プロジェクト行程

- 開発開始日:2024/1/1
- リリース予定日:2024/7/1
- 要件定義:~20242/1
- 基本設計:~2024/3/1
- 詳細設計:~2024/4/1
- 開発担当:~2024/5/1
- 結合テスト:~2024/6/1
- リリース:~2024/7/1

## 2.主要技術

| 言語・フレームワーク | バージョン |
| -------------------- | ---------- |
| nginx                | 1.25       |
| MySQL                | 8.0.33     |
| phpmyadmin           | latest     |
| Laravel              | 10.48.14   |
| Docker               | 26.1.4,    |

## 3.コマンド一覧

| コマンド                                               　| 実行する処理                         |
| ------------------------------------------------------ | ------------------------------------|
| docker-compose down                                    | Docker の停止                        |
| docker-compose up --build                              | Docker の build+起動                 |
| docker compose exec coteiner_naem php artisan migrate  | Docker コンテナに入り migrate を実行 　　　　　　　　|
| docker volume rm $(docker volume ls -qf dangling=true) | データボリュームの削除               　　　　　　　　　|
| docker builder prune --all --force                     | Docker 全てのキャッシュの削除        　　　　　　　　　|
| docker-compose down                                    | Docker の停止                        |                     |

## treeのインストール
sudo apt install tree

## tree実行
tree

## tree実行結果
.
└── laravel
    ├── README.md
    ├── composer.json
    ├── composer.lock
    ├── docker-compose.yml
    ├── package-lock.json
    ├── package.json
    ├── phpunit.xml
    ├── public
    │   ├── favicon.ico
    │   ├── index.php
    │   └── robots.txt
    └── vite.config.js

## 4.ディレクトリ構成

```
.
└── laravel
    ├── README.md
    ├── composer.json
    ├── composer.lock
    ├── docker-compose.yml
    ├── package-lock.json
    ├── package.json
    ├── phpunit.xml
    ├── public
    │   ├── favicon.ico
    │   ├── index.php
    │   └── robots.txt
    └── vite.config.js
```

## 5.開発環境構築方法

#### 1. Docker と Docker Compose のインストール

Docker と Docker Compose をインストールしてください。インストール方法は公式ドキュメントを参照してください。

#### 2. Laravel プロジェクトの準備

Laravel プロジェクトを作成

```
docker-compose run --rm composer create-project --prefer-dist laravel/laravel
```

#### 3. Docker Compose ファイルの設定

```
version: '3'

services:
  app:
    image: php:8.0-fpm
    container_name: laravel-app
    volumes:
      - .:/var/www/html
    networks:
      - laravel
    depends_on:
      - db

  db:
    image: mysql:5.7
    container_name: laravel-db
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_USER: laravel
      MYSQL_PASSWORD: secret
    networks:
      - laravel

  web:
    image: nginx:alpine
    container_name: laravel-web
    volumes:
      - ./docker/nginx/conf.d:/etc/nginx/conf.d
      - .:/var/www/html
    ports:
      - "8080:80"
    networks:
      - laravel
    depends_on:
      - app

  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    container_name: laravel-phpmyadmin
    environment:
      PMA_HOST: db
      MYSQL_ROOT_PASSWORD: secret
    ports:
      - "8081:80"
    networks:
      - laravel
    depends_on:
      - db

networks:
  laravel:
    driver: bridge
```

#### 4.Nginx の設定

./docker/nginx/conf.d/default.conf を作成し、以下の内容を追加します。

```
server {
    listen 80;
    server_name localhost;
    root /var/www/html/public;

    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass app:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

    error_log /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
}
```

#### 5.コンテナの起動

Laravel アプリケーション、MySQL、Nginx、PHPMyAdmin が起動させる。

```
docker-compose up -d

```

## 6.その他特記事項

### mysql の PORT の競合発生時の対処法

#### 1. Doker 停止

```
docker-compose down
```

#### 2. ポートの占有を確認

```
sudo lsof -i :3306
```

#### 3. ポートを解放

```

sudo kill -9 <PID>

```

#### 4. 再起動

```
docker-compose up --build