实战多阶段构建 Laravel 镜像

    新建一个 项目或在已有的 Laravel 项目根目录下新建 Dockerfile .dockerignore laravel.conf 文件。

    在 .dockerignore 文件中写入以下内容。

    在 laravel.conf 文件中写入 nginx 配置。

    1. server {
    2.   listen 80 default_server;
    3.   root /app/laravel/public;
    4.   index index.php index.html;
    6.   location / {
    7.       try_files $uri $uri/ /index.php?$query_string;
    8.   }
    10.   location ~ .*\.php(\/.*)*$ {
    11.     fastcgi_pass   laravel:9000;
    12.     include        fastcgi.conf;
    14.     # fastcgi_connect_timeout 300;
    15.     # fastcgi_send_timeout 300;
    16.     # fastcgi_read_timeout 300;
    17.   }
    18. }

    前端构建

    第一阶段进行前端构建。

    1. FROM node:alpine as frontend
    3. COPY package.json /app/
    5. RUN cd /app \
    6.       && npm install --registry=https://registry.npm.taobao.org
    8. COPY webpack.mix.js /app/
    9. COPY resources/assets/ /app/resources/assets/
    11. RUN cd /app \
    12.       && npm run production

    安装 Composer 依赖

    第三阶段对以上阶段生成的文件进行整合。

    2. ARG LARAVEL_PATH=/app/laravel
    4. COPY --from=composer /app/vendor/ ${LARAVEL_PATH}/vendor/
    6. COPY --from=frontend /app/public/js/ ${LARAVEL_PATH}/public/js/
    7. COPY --from=frontend /app/public/css/ ${LARAVEL_PATH}/public/css/
    8. COPY --from=frontend /app/mix-manifest.json ${LARAVEL_PATH}/mix-manifest.json
    10. RUN cd ${LARAVEL_PATH} \
    11.       && php artisan package:discover \
    12.       && mkdir -p storage \
    13.       && mkdir -p storage/framework/cache \
    14.       && mkdir -p storage/framework/sessions \
    15.       && mkdir -p storage/framework/testing \
    16.       && mkdir -p storage/framework/views \
    17.       && mkdir -p storage/logs \
    18.       && chmod -R 777 storage

    最后一个阶段构建 NGINX 镜像

    1. FROM nginx:alpine as nginx
    3. ARG LARAVEL_PATH=/app/laravel
    5. COPY laravel.conf /etc/nginx/conf.d/
    6. COPY --from=laravel ${LARAVEL_PATH}/public ${LARAVEL_PATH}/public

    构建 Laravel 及 Nginx 镜像

    使用 docker build 命令构建镜像。

    新建 Docker 网络

    1. $ docker network create laravel

    启动 laravel 容器， --name=laravel 参数设定的名字必须与 nginx 配置文件中的 fastcgi_pass laravel:9000; 一致

    1. $ docker run -it --rm --name=laravel --network=laravel my/laravel

    浏览器访问 127.0.0.1:8080 可以看到 Laravel 项目首页。

    也许 Laravel 项目依赖其他外部服务，例如 redis、MySQL，请自行启动这些服务之后再进行测试，本小节不再赘述。

    生产环境优化

    本小节内容为了方便测试，将配置文件直接放到了镜像中，实际在使用时 建议 将配置文件作为 config 或 secret 挂载到容器中，请读者自行学习 Swarm mode 或 Kubernetes 的相关内容。

    附录

    完整的 Dockerfile 文件如下。

    1. FROM node:alpine as frontend
    3. COPY package.json /app/
    5. RUN cd /app \
    6.       && npm install --registry=https://registry.npm.taobao.org
    8. COPY webpack.mix.js /app/
    9. COPY resources/assets/ /app/resources/assets/
    12.       && npm run production
    15. COPY database/ /app/database/
    16. COPY composer.json /app/
    18. RUN cd /app \
    19.       && composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \
    20.       && composer install \
    21.            --ignore-platform-reqs \
    22.            --no-interaction \
    23.            --no-plugins \
    24.            --no-scripts \
    25.            --prefer-dist
    27. FROM php:7.2-fpm-alpine as laravel
    29. ARG LARAVEL_PATH=/app/laravel
    31. COPY --from=composer /app/vendor/ ${LARAVEL_PATH}/vendor/
    32. COPY . ${LARAVEL_PATH}
    33. COPY --from=frontend /app/public/js/ ${LARAVEL_PATH}/public/js/
    34. COPY --from=frontend /app/public/css/ ${LARAVEL_PATH}/public/css/
    35. COPY --from=frontend /app/mix-manifest.json ${LARAVEL_PATH}/mix-manifest.json
    37. RUN cd ${LARAVEL_PATH} \
    38.       && php artisan package:discover \
    39.       && mkdir -p storage \
    40.       && mkdir -p storage/framework/cache \
    41.       && mkdir -p storage/framework/sessions \
    42.       && mkdir -p storage/framework/testing \
    43.       && mkdir -p storage/framework/views \
    44.       && mkdir -p storage/logs \
    45.       && chmod -R 777 storage
    47. FROM nginx:alpine as nginx
    49. ARG LARAVEL_PATH=/app/laravel
    51. COPY laravel.conf /etc/nginx/conf.d/