本文介绍如何制作PHP镜像并部署到Serverless应用引擎SAE(Serverless App Engine)。
背景信息
通常来说,您无需从空镜像开始安装PHP以及其他各种组件,而是可以通过dockerhub获取PHP官方镜像。官方的系统镜像是Debian或Alpine(Alpine镜像的体积小于Debian镜像),其中已经包含PHP以及一些辅助命令。官方镜像的版本命令规则如下:
php:8.0.12-cli-bullseye
:表示PHP版本为8.0.12,基于系统镜像bullseye(Debian 11)进行构建。其中cli
表示未开启CGI,即不能运行fpm
,只可运行命令行。
php:7.3.32-fpm-alpine3.13
:表示PHP版本为7.3.32,基于系统镜像alpine3.13进行构建。其中fpm
表示开启了CGI,可用来运行Web服务,也可用来运行CLI命令。
步骤一:制作基础镜像
基础镜像里包含常用的扩展和配置,在后续每次构建时就无需重复执行这些步骤。
- 创建项目文件。
- 创建一个用于存放PHP资源的项目文件夹,命名为php。
- 在PHP文件夹下,创建一个用于存放基础镜像资源的项目文件夹,命名为base。
- 执行以下命令,进入项目目录。
- 创建并编辑Dockerfile文件,文件内容如下:
FROM php:7.3.32-fpm-alpine3.13
LABEL MAINTAINER="sae@aliyun.com"
ENV TZ "Asia/Shanghai"
# 时区
RUN echo ${TZ} >/etc/timezone
# 可选
# COPY composer.phar /usr/local/bin/composer
# 创建www用户
RUN addgroup -g 1000 -S www && adduser -s /sbin/nologin -S -D -u 1000 -G www www
# 配置阿里云镜像源,加快构建速度。
RUN sed -i "s/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g" /etc/apk/repositories
# PHPIZE_DEPS包含gcc g++等编译辅助类库,完成后删除;pecl安装扩展。
RUN apk add --no-cache $PHPIZE_DEPS \
&& apk add --no-cache libstdc++ libzip-dev vim\
&& apk update \
&& pecl install redis-5.3.0 \
&& pecl install zip \
&& pecl install swoole \
&& docker-php-ext-enable redis zip swoole\
&& apk del $PHPIZE_DEPS
# docker-php-ext-install安装扩展。
RUN apk update \
&& apk add --no-cache nginx freetype libpng libjpeg-turbo freetype-dev libpng-dev libjpeg-turbo-dev \
&& docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ --with-png-dir=/usr/include/ \
&& docker-php-ext-install -j$(nproc) gd \
&& docker-php-ext-install -j$(nproc) pdo_mysql opcache bcmath mysqli
# 在run.sh
COPY run.sh /run.sh
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini" && mkdir -p /run/nginx/ && chmod +x /run.sh
ENTRYPOINT ["/run.sh"]
说明 该镜像文件同时采用pecl和docker-php-ext-install安装扩展,二者差异如下:
- pecl可以自动下载或者指定包安装扩展,安装完以后需要用docker-php-ext-enable启用扩展。
- docker-php-ext-install可以安装的扩展有限,可以通过docker-php-ext-install help查询可以安装的扩展列表,安装以后默认启用。
- 可选:修改镜像。
说明 步骤1的基础镜像将Nginx和PHP配置在同一个镜像内,同时启动php-fpm和nginx,符合常见的虚拟机部署习惯,但并不满足容器提倡的单进程管理模型。您可以考虑将php-fpm和nginx分别部署成两个应用,只需要针对上述镜像做少许修改即可。
创建并编辑
run.sh文件,文件内容如下:
#!/usr/bin/env sh
set -e
php-fpm -D
nginx -g 'daemon off;'
- 执行以下命令,构建镜像。
docker build -t php-bash:v1 .
输出示例如下:
Sending build context to Docker daemon 4.096kB
Step 1/11 : FROM php:7.3.32-fpm-alpine3.13
---> 2e127e9a****
......
Step 11/11 : ENTRYPOINT ["/run.sh"]
---> Using cache
---> dfde0cef****
Successfully built dfde0cef****
Successfully tagged php-bash:v1
步骤二:制作业务镜像
您可以按需对步骤一的镜像进行部分修改,以此作为您企业内使用的基础镜像,则后续的业务镜像都可以将其作为父镜像。
- 在php项目目录下,创建Dockerfile文件。
FROM php-bash:v1
# 把阿里云镜像地址换成内网地址,不开公网就可以安装各种软件。
RUN sed -i "s/mirrors.aliyun.com/mirrors.cloud.aliyuncs.com/g" /etc/apk/repositories && sed -i "s/https/http/g" /etc/apk/repositories
# php-fpm配置
COPY www.conf /usr/local/etc/php-fpm.d/www.conf
# Nginx配置
COPY default.conf /etc/nginx/http.d/
COPY index.php /var/www/html
- 创建并编辑www.conf文件,文件内容如下:
[www]
user = www
group = www
listen = 0.0.0.0:9000
pm = dynamic
pm.max_children = 100
pm.start_servers = 30
pm.min_spare_servers = 20
pm.max_spare_servers = 50
- 创建并编辑default.conf文件,文件内容如下:
server {
listen 80;
root /var/www/html;
index index.html index.htm index.php;
location ~ .*\.(php|php5)?$
{
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
access_log /tmp/nginx_access.log;
error_log /tmp/nginx_error.log;
}
- 创建并编辑index.php文件,文件内容如下:
<html>
<head>
<title>PHP Hello SAE!</title>
</head>
<body>
<?php echo '<h1>Hello SAE</h1>'; ?>
<?php phpinfo(); ?>
</body>
</html>
- 在容器镜像服务控制台创建两个镜像仓库,分别命名为php-base和php-server。
个人版和企业版实例均适用本文的操作,本文以个人版实例为例。具体操作,请参见以下文档:
- 构建并推送镜像。
您可以在目标镜像仓库的
基本信息页面的
镜像指南页签查询具体命令。更多信息,请参见以下文档:
- 执行以下命令,构建镜像。
docker build -t php-server:v1 .
输出示例如下:
Sending build context to Docker daemon 5.12kB
Step 1/5 : FROM php-bash:v1
---> dfde0cef****
......
Step 5/5 : COPY index.php /var/www/html
---> Using cache
---> e2c25424****
Successfully built e2c25424****
Successfully tagged php-server:v1
- 执行以下命令,登录远端镜像仓库。
本步骤假设您使用的是阿里云ACR仓库。
docker login --username=<镜像仓库登录名> registry.<regionId>.aliyuncs.com
示例如下:
docker login --username=****@188077086902**** registry.cn-hangzhou.aliyuncs.com
在返回结果中输入密码,如果显示
login succeeded
,则表示登录成功。如何设置密码,请参见
设置镜像仓库登录密码。
- 执行以下命令,给镜像打标签。
docker tag [ImageId] registry.<regionId>.aliyuncs.com/****/php-server:<镜像版本号>
ImageId
:镜像ID。
registry.<regionId>.aliyuncs.com/****/php-server
:镜像仓库地址。
示例如下:
docker tag php-server:v1 registry.cn-hangzhou.aliyuncs.com/php/php-server:v1
- 执行以下命令,推送镜像至个人版实例。
docker push registry.<regionId>.aliyuncs.com/php/php-server:<镜像版本号>
示例如下:
docker push registry.cn-hangzhou.aliyuncs.com/php/php-server:v1
步骤三:部署镜像
- 创建PHP应用。
- 为PHP应用绑定公网SLB。
选择
HTTP协议,并将
HTTP端口设置为
80,
容器端口设置为
80。具体操作,请参见
为应用绑定SLB。

绑定完成后,您可以在
应用访问设置区域查看公网访问地址。

- 结果验证。
按照
http://slbip:port/的格式,在浏览器地址栏输入
步骤2设置的公网地址并回车。结果如下:

更多信息
您如果不想每次都是手动构建、推送、部署,也可以考虑对接开源的jenkins或者阿里云云效。具体信息,请参见以下文档: