Container Description

This is a Dockerized Laravel Application built using the following containers:

• PHP Application

  `PHP8.0-fpm, Composer, NPM,

• MySQL

  MySQL Official Image

• Nginx

  Nginx Official Image

Getting started

Prerequisites:

• Docker Engine (v19.03.0+)
• Docker Compose

You can either:

• Install Docker Desktop (includes both Docker Engine and Docker Compose)

OR

• Install Docker Engine and Docker Compose separately.

Setup:

1. Open a new instance of the terminal, navigate to the root directory of the project and execute the following command to bring all the containers up.

   $ docker-compose up -d
   

   The command will take a while to run, since it will download/build the images for the first time. After the images are ready, it will start the containers. The next time you run this command it will be way faster to execute.

   note: any change you make to the Dockerfile or any other file that the Dockerfile uses (excluding docker-compose.yaml) you will need to build the images again for the changes to take effect by executing the following command.

   $ docker-compose build && docker-compose up -d
   

2. When all containers are up and running, enter the app container by executing the following command.

   $ docker-compose exec -ti app /bin/bash
   

3. Install all composer packages included in composer.json

   $ composer install
   

4. Install all npm packages included in package.json

   $ npm install
   

5. Run all mix tasks.

   $ npm run dev
   

6. Create a .env file from the existing .env.example

   $ cp .env.example .env
   

7. Generate a Laravel App Key.

   $ php artisan key:generate
   

8. Run the database migrations.

   $ php artisan migrate
   

9. Modify the following fields in your .env file to use the values specified in the database container.

   DB_CONNECTION=mysql
   DB_HOST=db
   DB_PORT=3306
   DB_DATABASE=Data
   DB_USERNAME=root123
   DB_PASSWORD=root123
   

10. To access your Laravel Application visit http://localhost:8000

Stopping the containers

1. Exit the app container.

   $ exit
   

2. Bring all the containers down.

   $ docker-compose down