PHP 7.1 Docker镜像

概述和主要用途

该容器镜像包含PHP 7.1，作为S2I基础镜像，用于构建和运行PHP 7.1应用程序。用户可选择基于RHEL、CentOS或Fedora的构建器镜像，分别在Red Hat容器目录、Docker Hub和Fedora Registry提供。生成的镜像可使用podman或docker运行（本文档示例中podman命令可替换为docker，参数相同）。

核心功能和特性

• 作为构建和运行各类PHP 7.1应用及框架的基础平台
• 支持HTML嵌入式脚本语言，简化动态网页开发
• 内置多数据库集成，便于编写数据库驱动网页
• 包含npm工具，支持安装JavaScript模块（nodejs版本不保证，仅为npm提供运行环境）
• 提供丰富的环境变量配置，支持PHP、opcache、Apache等参数自定义
• 支持热部署，可实时更新应用源代码
• 允许通过特定目录结构扩展镜像配置和启动脚本

使用场景和适用范围

适用于需要在容器化环境中构建、部署和运行PHP 7.1应用程序的场景，包括：

• 开发基于PHP 7.1的动态网站和Web应用
• 在OpenShift、Docker等容器平台部署PHP应用
• 需要集成npm管理JavaScript依赖的PHP项目
• 需自定义PHP配置、Apache设置或扩展镜像功能的场景

使用方法和配置说明

基本使用示例

在OpenShift中构建应用

使用php:7.1镜像流标签（对应rhscl/php-71-rhel7镜像）构建测试应用：

oc new-app php:7.1~[***] --context-dir=7.1/test/test-app/

使用S2I工具构建应用

在安装S2I的系统上构建：

s2i build [***] --context-dir=7.1/test/test-app/ rhscl/php-71-rhel7 php-sample-app

访问应用

curl 127.0.0.1:8080

环境变量配置

PHP配置相关变量

通过.s2i/environment文件设置，对应php.ini属性：

Opcache配置变量

对应opcache.ini属性：

• OPCACHE_MEMORY_CONSUMPTION
  OPcache共享内存存储大小（MB），默认值：128
• OPCACHE_REVALIDATE_FREQ
  脚本时间戳更新检查频率（秒），0表示每次请求都检查，默认值：2

PHP配置目录覆盖

• PHPRC：设置php.ini文件路径
• PHP_INI_SCAN_DIR：扫描额外ini配置文件的路径

Apache MPM Prefork设置

用于调整Apache性能，支持自动根据Cgroup限制优化（可手动覆盖）：

• HTTPD_START_SERVERS
  启动时创建的子服务器进程数，默认值：8
• HTTPD_MAX_REQUEST_WORKERS
  同时服务的最大请求数（httpd 2.3.13前称为MaxClients），默认值：256（通过TOTAL_MEMORY / 15MB自动计算，15MB为单个httpd进程平均大小）

Composer相关设置

• COMPOSER_MIRROR：添加自定义Composer仓库镜像URL（仅影响composer.json中包）
• COMPOSER_INSTALLER：覆盖Composer安装器下载URL（默认：[***]
• COMPOSER_ARGS：为composer install添加额外参数（如--no-dev）

源仓库布局

现有PHP项目无需修改，以下文件影响构建过程：

• composer.json：通过composer安装的依赖列表，格式见Composer schema
• .htaccess：当DocumentRoot嵌套在/opt/app-root/src时，用于覆盖Apache行为，需位于源代码根目录

热部署

实时获取代码更改：

1. 运行镜像时设置环境变量：

podman run -e OPCACHE_REVALIDATE_FREQ=0 -p 8080:8080 php-app

2. 通过podman exec进入容器修改代码：

podman exec -it <CONTAINER_ID> /bin/bash

进入后当前目录为源代码目录/opt/app-root/src。

扩展镜像

通过S2I扩展配置和启动脚本，支持以下目录结构：

相关链接

Dockerfile及源码见GitHub仓库，包含各系统版本：CentOS（Dockerfile）、RHEL7（Dockerfile.rhel7）、RHEL8（Dockerfile.rhel8）、Fedora（Dockerfile.fedora）。

安全注意事项

-p 8080:8080：开放容器8080端口并映射到主机相同端口。