实战多阶段构建 Laravel 镜像

本节适用于 PHP 开发者阅读。Laravel 基于 8.x 版本，各个版本的文件结构可能会有差异，请根据实际自行修改。

准备

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

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

  1. .idea/
  2. .git/
  4. vendor/
  6. node_modules/
  8. public/js/
  9. public/css/
  10. public/mix-manifest.json
  12. yarn-error.log
  14. bootstrap/cache/*
  15. storage/
  17. # 自行添加其他需要排除的文件，例如 .env.* 文件

在 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 set -x ; cd /app \
  6.       && npm install --registry=https://registry.npm.taobao.org
  8. COPY webpack.mix.js /app/
  9. COPY resources/ /app/resources/
  11. RUN set -x ; cd /app \
  12.       && touch artisan \
  13.       && mkdir -p public \
  14.       && npm run production

安装 Composer 依赖

第二阶段安装 Composer 依赖。

  1. FROM composer as composer
  3. COPY database/ /app/database/
  4. COPY composer.json composer.lock /app/
  6. RUN set -x ; cd /app \
  7.       && composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \
  8.       && composer install \
  9.            --ignore-platform-reqs \
  10.            --no-interaction \
  11.            --no-plugins \
  12.            --no-scripts \
  13.            --prefer-dist

整合以上阶段所生成的文件

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

  1. FROM php:7.4-fpm-alpine as laravel
  3. ARG LARAVEL_PATH=/app/laravel
  5. COPY --from=composer /app/vendor/ ${LARAVEL_PATH}/vendor/
  6. COPY . ${LARAVEL_PATH}
  7. COPY --from=frontend /app/public/js/ ${LARAVEL_PATH}/public/js/
  8. COPY --from=frontend /app/public/css/ ${LARAVEL_PATH}/public/css/
  9. COPY --from=frontend /app/public/mix-manifest.json ${LARAVEL_PATH}/public/mix-manifest.json
  11. RUN set -x ; cd ${LARAVEL_PATH} \
  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 \
  19.       && php artisan package:discover

最后一个阶段构建 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 命令构建镜像。

  1. $ docker build -t my/laravel --target=laravel .
  3. $ docker build -t my/nginx --target=nginx .

启动容器并测试

新建 Docker 网络

  1. $ docker network create laravel

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

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

启动 nginx 容器

  1. $ docker run -dit --rm --network=laravel -p 8080:80 my/nginx

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

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

生产环境优化

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

由于篇幅所限本小节只是简单列出，更多内容可以参考 https://github.com/khs1994-docker/laravel-demo 项目。

附录

完整的 Dockerfile 文件如下。

  1. FROM node:alpine as frontend
  3. COPY package.json /app/
  5. RUN set -x ; cd /app \
  6.       && npm install --registry=https://registry.npm.taobao.org
  8. COPY webpack.mix.js /app/
  9. COPY resources/ /app/resources/
  11. RUN set -x ; cd /app \
  12.       && touch artisan \
  13.       && mkdir -p public \
  14.       && npm run production
  16. FROM composer as composer
  18. COPY database/ /app/database/
  19. COPY composer.json /app/
  21. RUN set -x ; cd /app \
  22.       && composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \
  23.       && composer install \
  24.            --ignore-platform-reqs \
  25.            --no-interaction \
  26.            --no-plugins \
  27.            --no-scripts \
  28.            --prefer-dist
  30. FROM php:7.4-fpm-alpine as laravel
  32. ARG LARAVEL_PATH=/app/laravel
  34. COPY --from=composer /app/vendor/ ${LARAVEL_PATH}/vendor/
  35. COPY . ${LARAVEL_PATH}
  36. COPY --from=frontend /app/public/js/ ${LARAVEL_PATH}/public/js/
  37. COPY --from=frontend /app/public/css/ ${LARAVEL_PATH}/public/css/
  38. COPY --from=frontend /app/public/mix-manifest.json ${LARAVEL_PATH}/public/mix-manifest.json
  40. RUN set -x ; cd ${LARAVEL_PATH} \
  41.       && mkdir -p storage \
  42.       && mkdir -p storage/framework/cache \
  43.       && mkdir -p storage/framework/sessions \
  44.       && mkdir -p storage/framework/testing \
  45.       && mkdir -p storage/framework/views \
  46.       && mkdir -p storage/logs \
  47.       && chmod -R 777 storage \
  48.       && php artisan package:discover
  50. FROM nginx:alpine as nginx
  52. ARG LARAVEL_PATH=/app/laravel
  54. COPY laravel.conf /etc/nginx/conf.d/
  55. COPY --from=laravel ${LARAVEL_PATH}/public ${LARAVEL_PATH}/public