Create local develop environment Lavarel by Docker (Apache version)

Repository

https://github.com/ucan-lab/docker-laravel-apache

Cách dùng

A. Tạo mới Project Laravel

$ git clone _@.com:ucan-lab/docker-laravel-apache.git
$ cd docker-laravel-apache
$ make create-project

http://localhost

Bằng 3 bước trên là hoàn thành xây dựng môi trường cho project mới của Laravel.

A'. Chỉ định version rồi tạo mới project Laravel

Ghi phần install Laravel của phần Makefile

 docker-compose exec app composer create-project --prefer-dist "laravel/laravel=6.*" .

B. Xây dựng môi trường Laravel project

$ git clone _@.com:ucan-lab/docker-laravel-apache.git # Clone Laravel project sang docker-laravel-apache/backend $ git clone _@.com:laravel/laravel.git docker-laravel-apache/backend $ cd docker-laravel-apache
$ make init

http://localhost

Bằng cách này là hoàn thành xây dựng môi trường project Laravel đã có.

Cấu trúc container

├── web
└── db

cấu tạo bằng 2 container là web, db.

Khác biệt với nginx

Với trường hợp Nginx thì thường chia ra php-fpm(application server) và container. Với trường hợp Apache, module mod_php default được install, module này vừa là application server mà bên PHP chạy đồng thời cũng là web server.

Cấu trúc directory

.
├── backend # route directory của project Laravel
├── infra
│ └── docker
│ ├── apache
│ │ └── httpd.conf
│ ├── mysql
│ │ ├── Dockerfile
│ │ └── my.cnf
│ └── php
│ ├── Dockerfile
│ └── php.ini
├── .env.example
├── Makefile
└── docker-compose.yml

Khác biệt với bản nginx

※Điểm khác biệt với bản nginx là có thay đổi trong apache directory.

• infra/docker/apache/httpd.conf
• infra/docker/php/Dockerfile
• Makefile
• docker-compose.yml

Về điểm thay đổi này các bạn chỉ cần chú ý đến 4 file nêu trên là được. Ngoài ra có thể check được chi tiết diff bằng PR sau:

• https://github.com/ucan-lab/docker-laravel-apache/pull/2
• https://github.com/ucan-lab/docker-laravel-apache/pull/4

Base container của PHP

• https://hub.docker.com/_/php
• https://github.com/docker-library/php/tree/master/7.4/buster/apache

Trong image tag php:<version>-apache có kèm.

Giải tích

docker-compose.yml

version: "3.8"
volumes: db-store:
services: web: build: context: . dockerfile: ./infra/docker/php/Dockerfile ports: - ${WEB_PORT:-80}:80 volumes: - ./backend:/work/backend environment: - DB_CONNECTION=mysql - DB_HOST=db - DB_PORT=3306 - DB_DATABASE=${DB_NAME:-laravel_local} - DB_USERNAME=${DB_USER:-phper} - DB_PASSWORD=${DB_PASS:-secret} db: build: context: . dockerfile: ./infra/docker/mysql/Dockerfile ports: - ${DB_PORT:-3306}:3306 volumes: - db-store:/var/lib/mysql environment: - MYSQL_DATABASE=${DB_NAME:-laravel_local} - MYSQL_USER=${DB_USER:-phper} - MYSQL_PASSWORD=${DB_PASS:-secret} - MYSQL_ROOT_PASSWORD=${DB_PASS:-secret}

Gộp app với wb container, để chỉ còn web container thôi.

infra/docker/php/Dockerfile

FROM node:14-buster as node
FROM php:7.4-apache-buster
LABEL maintainer="ucan-lab <_@.com>"
SHELL ["/bin/bash", "-oeux", "pipefail", "-c"] # timezone environment
ENV TZ=UTC \ # locale LANG=en_US.UTF-8 \ LANGUAGE=en_US:en \ LC_ALL=en_US.UTF-8 \ # composer environment COMPOSER_ALLOW_SUPERUSER=1 \ COMPOSER_HOME=/composer # composer command
COPY --from=composer:2.0 /usr/bin/composer /usr/bin/composer
# node command
COPY --from=node /usr/local/bin /usr/local/bin
# npm command
COPY --from=node /usr/local/lib /usr/local/lib
# yarn command
COPY --from=node /opt /opt RUN apt-get update && \ apt-get -y install git libicu-dev libonig-dev libzip-dev unzip locales && \ apt-get clean && \ rm -rf /var/lib/apt/lists/* && \ locale-gen en_US.UTF-8 && \ localedef -f UTF-8 -i en_US en_US.UTF-8 && \ a2enmod rewrite && \ docker-php-ext-install intl pdo_mysql zip bcmath && \ composer config -g process-timeout 3600 && \ composer config -g repos.packagist composer https://packagist.org COPY ./infra/docker/php/php.ini /usr/local/etc/php/php.ini
COPY ./infra/docker/apache/httpd.conf /etc/apache2/sites-available/000-default.conf WORKDIR /work/backend

3 container - php, composer, node dùng multi stage build. (có apache trong image của php)

Tùy vào trường hợp nếu không cần node thì có thể xóa khỏi Dockerfile. Để cho có tính toàn cầu hóa thì về phần language và timezone để tiếng anh. Trên thực tế tùy mục đích khu vực sử dụng mà thay đổi chỗ ngôn ngữ được.

a2enmod rewrite sẽ active module mod_rewrite của Apache. Nếu không có cái này thì routing của Lavarel sẽ không chạy được.

infra/docker/apache/httpd.conf

<VirtualHost *:80> ServerName example.com ServerAdmin _@.com DocumentRoot /work/backend/public ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined <Directory /work/backend/public> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory>
</VirtualHost>

Hiện tại chỉ set những mục nào bắt buộc thôi.