/docker-compose-laravel-alpine-for-mac-m1

A pretty simplified Docker Compose workflow that sets up a LNMP network of containers for local Laravel development on Mac M1.

Primary LanguageDockerfileApache License 2.0Apache-2.0

Docker-compose-laravel-alpine-for-mac-m1

A pretty simplified Docker Compose workflow that sets up a LNMP network of containers for local Laravel development on Mac M1.

You can modify the version of the images in the file "docker-compose.yml" or the Dockfile for the specific needs.

The following are built for our web server, with their exposed ports detailed:

  • nginx:stable-alpine - :80
  • mysql/mysql-server:latest-aarch64 - :3306
  • php:7.4.16-fpm-alpine3.13 - :9000
  • redis:alpine - :6379

The images are minimized as much as possible:

  • docker_php 135MB
  • redis 28.1MB
  • nginx 22.1MB
  • mysql/mysql-server 489MB

Prerequisites

To get started, make sure you have Docker installed on your system, and then clone this repository.

For the user of Mac M1, please follow Docker Desktop for Apple Silicon

Quick start

Step 1 - Spin up the containers for the web server

Navigate in your terminal to the directory you cloned this, and spin up the containers for the web server by running :

  • docker-compose up -d --build

Optional:

up without building,just run:

  • docker-compose up -d

Stops containers and removes containers, networks, volumes, and images created by up . By default, the only things removed are: Containers for services defined in the Compose file.

  • docker-compose down

Stop the container,"php" is the name of the container

  • docker-compose stop php

Start the containers,"php" is the name of the container

  • docker-compose start php

Step 2 - Get your Laravel project added in

follow the steps from the wwwroot/README.md file to get your Laravel project added in (or create a new blank one).

The usage of the project

PHP Service (composer included)

  • Accessing the Container Shell

    docker exec -it php sh
    
  • The mapped directory the service container for php

      volumes:
        - ./wwwroot:/var/www
        - ./php/php.ini:/usr/local/etc/php/php.ini
    
  • Composer install

    docker exec -w /var/www/your-site-root php composer install
    
  • Laravel: php artisan

    docker exec -w /var/www/your-site-root php php artisan serve
    docker exec -w /var/www/your-site-root php artisan migrate
    

The list of php extensions in the project

  • bcmath
  • gd
  • imap
  • intl
  • memcached
  • mysqlnd
  • pcntl
  • pdo_mysql
  • redis
  • tidy
  • Zend OPcache
  • zip
  • zlib
  • xdebug

Nginx Service

  • Accessing the Container Shell
      docker exec -it nginx  sh
    
  • The mapped directory the service container for nginx
      volumes:
        - ./wwwroot:/var/www
        - ./nginx/conf.d/:/etc/nginx/conf.d/
        - ./nginx/log:/var/log/nginx
    

MySQL Service

  • Mysql Client: Default password :12345678

    docker exec -it mysql mysql -uroot -p
    
  • The mapped directory the service container for mysql

    volumes:
        - mysqldata:/var/lib/mysql      
        - ./mysql/my.cnf:/etc/mysql/my.cnf 
    
  • Starting with MySQL 8 you no longer can (implicitly) create a user using the GRANT command. Use CREATE USER instead, followed by the GRANT statement

    mysql> CREATE USER 'root'@'%' IDENTIFIED BY 'PASSWORD';
    mysql> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;
    mysql> FLUSH PRIVILEGES;
    

    Caution: about the security risks about WITH GRANT OPTION, see: Grant all privileges on database

  • Now, you can use any MySQL Client program to connect with MySQL Server,running on the container

    HOST:127.0.0.1
    PORT:3306
    USER:root
    PASSWORD:12345678 
    

Redis Service

  • Redis Client: Default password :(empty)
    docker exec -it redis redis-cli
    
  • The mapped directory the service container for redis
    volumes:
      - redisdata:/data
      - ./redis/conf:/usr/local/etc/redis
      - ./redis/log:/log