实战多阶段构建 Laravel 镜像

最后更新于:2022-04-01 21:29:02

# 实战多阶段构建 Laravel 镜像 > 本节适用于 PHP 开发者阅读。`Laravel` 基于 8.x 版本,各个版本的文件结构可能会有差异,请根据实际自行修改。 ## 准备 新建一个 `Laravel` 项目或在已有的 `Laravel` 项目根目录下新建 `Dockerfile` `.dockerignore` `laravel.conf` 文件。 在 `.dockerignore` 文件中写入以下内容。 ```bash .idea/ .git/ vendor/ node_modules/ public/js/ public/css/ public/mix-manifest.json yarn-error.log bootstrap/cache/* storage/ # 自行添加其他需要排除的文件,例如 .env.* 文件 ``` 在 `laravel.conf` 文件中写入 nginx 配置。 ```nginx server { listen 80 default_server; root /app/laravel/public; index index.php index.html; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ .*\.php(\/.*)*$ { fastcgi_pass laravel:9000; include fastcgi.conf; # fastcgi_connect_timeout 300; # fastcgi_send_timeout 300; # fastcgi_read_timeout 300; } } ``` ## 前端构建 第一阶段进行前端构建。 ```docker FROM node:alpine as frontend COPY package.json /app/ RUN set -x ; cd /app \ && npm install --registry=https://registry.npm.taobao.org COPY webpack.mix.js /app/ COPY resources/ /app/resources/ RUN set -x ; cd /app \ && touch artisan \ && mkdir -p public \ && npm run production ``` ## 安装 Composer 依赖 第二阶段安装 Composer 依赖。 ```docker FROM composer as composer COPY database/ /app/database/ COPY composer.json composer.lock /app/ RUN set -x ; cd /app \ && composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \ && composer install \ --ignore-platform-reqs \ --no-interaction \ --no-plugins \ --no-scripts \ --prefer-dist ``` ## 整合以上阶段所生成的文件 第三阶段对以上阶段生成的文件进行整合。 ```docker FROM php:7.4-fpm-alpine as laravel ARG LARAVEL_PATH=/app/laravel COPY --from=composer /app/vendor/ ${LARAVEL_PATH}/vendor/ COPY . ${LARAVEL_PATH} COPY --from=frontend /app/public/js/ ${LARAVEL_PATH}/public/js/ COPY --from=frontend /app/public/css/ ${LARAVEL_PATH}/public/css/ COPY --from=frontend /app/public/mix-manifest.json ${LARAVEL_PATH}/public/mix-manifest.json RUN set -x ; cd ${LARAVEL_PATH} \ && mkdir -p storage \ && mkdir -p storage/framework/cache \ && mkdir -p storage/framework/sessions \ && mkdir -p storage/framework/testing \ && mkdir -p storage/framework/views \ && mkdir -p storage/logs \ && chmod -R 777 storage \ && php artisan package:discover ``` ## 最后一个阶段构建 NGINX 镜像 ```docker FROM nginx:alpine as nginx ARG LARAVEL_PATH=/app/laravel COPY laravel.conf /etc/nginx/conf.d/ COPY --from=laravel ${LARAVEL_PATH}/public ${LARAVEL_PATH}/public ``` ## 构建 Laravel 及 Nginx 镜像 使用 `docker build` 命令构建镜像。 ```bash $ docker build -t my/laravel --target=laravel . $ docker build -t my/nginx --target=nginx . ``` ## 启动容器并测试 新建 Docker 网络 ```bash $ docker network create laravel ``` 启动 laravel 容器, `--name=laravel` 参数设定的名字必须与 `nginx` 配置文件中的 `fastcgi_pass laravel:9000;` 一致 ```bash $ docker run -dit --rm --name=laravel --network=laravel my/laravel ``` 启动 nginx 容器 ```bash $ 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` 文件如下。 ```docker FROM node:alpine as frontend COPY package.json /app/ RUN set -x ; cd /app \ && npm install --registry=https://registry.npm.taobao.org COPY webpack.mix.js /app/ COPY resources/ /app/resources/ RUN set -x ; cd /app \ && touch artisan \ && mkdir -p public \ && npm run production FROM composer as composer COPY database/ /app/database/ COPY composer.json /app/ RUN set -x ; cd /app \ && composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \ && composer install \ --ignore-platform-reqs \ --no-interaction \ --no-plugins \ --no-scripts \ --prefer-dist FROM php:7.4-fpm-alpine as laravel ARG LARAVEL_PATH=/app/laravel COPY --from=composer /app/vendor/ ${LARAVEL_PATH}/vendor/ COPY . ${LARAVEL_PATH} COPY --from=frontend /app/public/js/ ${LARAVEL_PATH}/public/js/ COPY --from=frontend /app/public/css/ ${LARAVEL_PATH}/public/css/ COPY --from=frontend /app/public/mix-manifest.json ${LARAVEL_PATH}/public/mix-manifest.json RUN set -x ; cd ${LARAVEL_PATH} \ && mkdir -p storage \ && mkdir -p storage/framework/cache \ && mkdir -p storage/framework/sessions \ && mkdir -p storage/framework/testing \ && mkdir -p storage/framework/views \ && mkdir -p storage/logs \ && chmod -R 777 storage \ && php artisan package:discover FROM nginx:alpine as nginx ARG LARAVEL_PATH=/app/laravel COPY laravel.conf /etc/nginx/conf.d/ COPY --from=laravel ${LARAVEL_PATH}/public ${LARAVEL_PATH}/public ```
';