制作PHP镜像

本文介绍如何制作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命令。

步骤一:制作基础镜像

基础镜像里包含常用的扩展和配置,在后续每次构建时就无需重复执行这些步骤。

  1. 创建项目文件。

    1. 创建一个用于存放PHP资源的项目文件夹,命名为php

    2. 在PHP文件夹下,创建一个用于存放基础镜像资源的项目文件夹,命名为base

  2. 执行以下命令,进入项目目录。

    cd php/base
  3. 创建并编辑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查询可以安装的扩展列表,安装以后默认启用。

  4. 可选:修改镜像。

    说明

    步骤1的基础镜像将Nginx和PHP配置在同一个镜像内,同时启动php-fpm和nginx,符合常见的虚拟机部署习惯,但并不满足容器提倡的单进程管理模型。您可以考虑将php-fpm和nginx分别部署成两个应用,只需要针对上述镜像做少许修改即可。

    创建并编辑run.sh文件,文件内容如下:

    #!/usr/bin/env sh
    set -e
    
    php-fpm -D
    nginx -g 'daemon off;'
  5. 执行以下命令,构建镜像。

    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

步骤二:制作业务镜像

您可以按需对步骤一的镜像进行部分修改,以此作为您企业内使用的基础镜像,则后续的业务镜像都可以将其作为父镜像。

  1. 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
  2. 创建并编辑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
  3. 创建并编辑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;
    }
  4. 创建并编辑index.php文件,文件内容如下:

    <html>
        <head>
            <title>PHP Hello SAE!</title>
        </head>
        <body>
            <?php echo '<h1>Hello SAE</h1>'; ?>
            <?php phpinfo(); ?>
        </body>
    </html>
  5. 容器镜像服务控制台创建两个镜像仓库,分别命名为php-basephp-server

    个人版和企业版实例均适用本文的操作,本文以个人版实例为例。具体操作,请参见以下文档:

  6. 构建并推送镜像。

    您可以在目标镜像仓库的基本信息页面的镜像指南页签查询具体命令。更多信息,请参见以下文档:

    1. 执行以下命令,构建镜像。

      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
    2. 执行以下命令,登录远端镜像仓库。

      本步骤假设您使用的是阿里云ACR仓库。

      docker login --username=<镜像仓库登录名> registry.<regionId>.aliyuncs.com

      示例如下:

      docker login --username=****@188077086902**** registry.cn-hangzhou.aliyuncs.com

      在返回结果中输入密码,如果显示login succeeded,则表示登录成功。如何设置密码,请参见设置镜像仓库登录密码

    3. 执行以下命令,给镜像打标签。

      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
    4. 执行以下命令,推送镜像至个人版实例。

      docker push registry.<regionId>.aliyuncs.com/php/php-server:<镜像版本号>

      示例如下:

      docker push registry.cn-hangzhou.aliyuncs.com/php/php-server:v1

    成功推送后,您可以登录容器镜像服务控制台,在目标镜像仓库的镜像版本页面查看推送的版本。

步骤三:部署镜像

  1. 创建PHP应用。

    应用部署配置配置向导页面,技术栈语言需选择PHP应用部署方式需选择镜像。具体操作,请参见在SAE控制台使用镜像部署PHP应用sc_create_PHP_application_via_image

    说明

    除创建新应用外,您还可以修改现有应用的配置镜像。具体操作,请参见升级应用

  2. 为PHP应用绑定公网SLB。

    选择HTTP协议,并将HTTP端口设置为80容器端口设置为80。具体操作,请参见为应用绑定CLBsc_create_slb_for_PHP

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

  3. 结果验证。

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

更多信息

文档

说明

部署PHP应用至SAE

在Jenkins中使用SAE插件构建应用部署的任务

如果您不想每次都通过手动方式构建、推送镜像,并部署应用,可以对接开源的Jenkins或者阿里云云效

在SAE控制台使用镜像部署PHP应用

可以使用SAE提供的Demo镜像部署PHP应用。