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

准备

新建一个 Laravel 项目或在已有的 Laravel 项目根目录下新建 Dockerfile .dockerignore laravel.conf 文件。
.dockerignore 文件中写入以下内容。
1
.idea/
2
.git/
3
4
vendor/
5
6
node_modules/
7
8
public/js/
9
public/css/
10
public/mix-manifest.json
11
12
yarn-error.log
13
14
bootstrap/cache/*
15
storage/
16
17
# 自行添加其他需要排除的文件,例如 .env.* 文件
Copied!
laravel.conf 文件中写入 nginx 配置。
1
server {
2
listen 80 default_server;
3
root /app/laravel/public;
4
index index.php index.html;
5
6
location / {
7
try_files $uri $uri/ /index.php?$query_string;
8
}
9
10
location ~ .*\.php(\/.*)*$ {
11
fastcgi_pass laravel:9000;
12
include fastcgi.conf;
13
14
# fastcgi_connect_timeout 300;
15
# fastcgi_send_timeout 300;
16
# fastcgi_read_timeout 300;
17
}
18
}
Copied!

前端构建

第一阶段进行前端构建。
1
FROM node:alpine as frontend
2
3
COPY package.json /app/
4
5
RUN set -x ; cd /app \
6
&& npm install --registry=https://registry.npm.taobao.org
7
8
COPY webpack.mix.js webpack.config.js tailwind.config.js /app/
9
COPY resources/ /app/resources/
10
11
RUN set -x ; cd /app \
12
&& touch artisan \
13
&& mkdir -p public \
14
&& npm run production
Copied!

安装 Composer 依赖

第二阶段安装 Composer 依赖。
1
FROM composer as composer
2
3
COPY database/ /app/database/
4
COPY composer.json composer.lock /app/
5
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
Copied!

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

第三阶段对以上阶段生成的文件进行整合。
1
FROM php:7.4-fpm-alpine as laravel
2
3
ARG LARAVEL_PATH=/app/laravel
4
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
10
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
Copied!

最后一个阶段构建 NGINX 镜像

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

构建 Laravel 及 Nginx 镜像

使用 docker build 命令构建镜像。
1
$ docker build -t my/laravel --target=laravel .
2
3
$ docker build -t my/nginx --target=nginx .
Copied!

启动容器并测试

新建 Docker 网络
1
$ docker network create laravel
Copied!
启动 laravel 容器, --name=laravel 参数设定的名字必须与 nginx 配置文件中的 fastcgi_pass laravel:9000; 一致
1
$ docker run -dit --rm --name=laravel --network=laravel my/laravel
Copied!
启动 nginx 容器
1
$ docker run -dit --rm --network=laravel -p 8080:80 my/nginx
Copied!
浏览器访问 127.0.0.1:8080 可以看到 Laravel 项目首页。
也许 Laravel 项目依赖其他外部服务,例如 redis、MySQL,请自行启动这些服务之后再进行测试,本小节不再赘述。

生产环境优化

本小节内容为了方便测试,将配置文件直接放到了镜像中,实际在使用时 建议 将配置文件作为 configsecret 挂载到容器中,请读者自行学习 Swarm modeKubernetes 的相关内容。
由于篇幅所限本小节只是简单列出,更多内容可以参考 https://github.com/khs1994-docker/laravel-demo 项目。

附录

完整的 Dockerfile 文件如下。
1
FROM node:alpine as frontend
2
3
COPY package.json /app/
4
5
RUN set -x ; cd /app \
6
&& npm install --registry=https://registry.npm.taobao.org
7
8
COPY webpack.mix.js webpack.config.js tailwind.config.js /app/
9
COPY resources/ /app/resources/
10
11
RUN set -x ; cd /app \
12
&& touch artisan \
13
&& mkdir -p public \
14
&& npm run production
15
16
FROM composer as composer
17
18
COPY database/ /app/database/
19
COPY composer.json /app/
20
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
29
30
FROM php:7.4-fpm-alpine as laravel
31
32
ARG LARAVEL_PATH=/app/laravel
33
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
39
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
49
50
FROM nginx:alpine as nginx
51
52
ARG LARAVEL_PATH=/app/laravel
53
54
COPY laravel.conf /etc/nginx/conf.d/
55
COPY --from=laravel ${LARAVEL_PATH}/public ${LARAVEL_PATH}/public
Copied!
Last modified 6mo ago