erseco/alpine-php-webserver Docker 镜像 - 轩辕镜像

Docker PHP-FPM 8.4 & Nginx 1.28 基于阿尔卑斯Linux 3.22

![Docker Pulls]([***] !Docker Image Size !alpine 3.22 !nginx 1.28 !php 8.4 !License MIT

基于阿尔卑斯Linux构建的Docker PHP-FPM 8.4 & Nginx 1.28示例配置，镜像大小仅约25MB。

仓库：[***]

• 基于轻量级且安全的阿尔卑斯Linux发行版构建
• 极小的Docker镜像大小（约25MB）
• 使用PHP 8.4提升性能、降低CPU使用率和内存占用
• 多架构支持：386、amd64、arm/v6、arm/v7、arm64、ppc64le、s390x
• 优化支持100个并发用户
• 优化为仅在有流量时使用资源（通过PHP-FPM的ondemand进程管理器）
• 使用runit而非supervisord以减少内存占用
• Nginx、PHP-FPM服务以非特权用户（nobody）运行，提升安全性
• 所有服务日志重定向至Docker容器输出（可通过docker logs -f <容器名称>查看）
• 遵循KISS原则（保持简单），便于理解和调整镜像以满足需求

支持的标签及对应Dockerfile链接

• latest, 3, 3.22, 3.22.1-1 (Dockerfile)
• 3.21, 3.21.4 (Dockerfile)
• 3.20, 3.20.7 (Dockerfile)

注意：main分支（Dockerfile）会自动推送到标签**beta**。
在稳定版本发布前，可使用此标签进行测试。

使用方法

启动Docker容器：

docker run -p 80:8080 erseco/alpine-php-webserver

在http://localhost查看PHP信息，或在http://localhost/test.html查看静态HTML页面。

或挂载本地代码以通过PHP-FPM & Nginx提供服务：

docker run -p 80:8080 -v ~/我的代码库:/var/www/html erseco/alpine-php-webserver

使用Docker Compose运行

通过Docker Compose轻松提供本地PHP文件服务。此配置将本地./php目录挂载到容器，并绑定到本地8080端口，使PHP文件的更改能通过Web服务器即时反映，非常适合本地开发和测试。

Docker Compose配置

以下是简单的docker-compose.yml示例：

yaml
services:
  webserver:
    image: erseco/alpine-php-webserver
    ports:
      - 8080:8080
    volumes:
      - ./php:/var/www/html
    restart: unless-stopped

• image：使用erseco/alpine-php-webserver，针对PHP应用优化。
• ports：将容器8080端口映射到本地8080端口，可通过http://localhost:8080访问。
• volumes：将本地./php目录挂载到容器/var/www/html，实现PHP文件实时更新。
• restart：确保容器除非手动停止，否则自动重启，提升可靠性。

使用步骤

1. 在项目目录中保存上述docker-compose.yml文件。
2. 在终端中进入该目录，运行docker compose up -d。
3. 通过http://localhost:8080访问PHP应用。

此方法确保无缝的开发流程，让你专注于编码而非环境配置。

添加额外守护进程

可通过创建runit条目添加额外守护进程（如自定义应用）。只需编写一个运行守护进程的小型shell脚本（命名为run，需可执行），并放置在/etc/service/<名称>目录下。runit会自动管理该进程，在崩溃时重启等。

以下示例展示如何创建memcached服务器的runit条目：

#!/bin/sh
### 在memcached.sh中（确保文件权限为chmod +x）：
# `chpst -u memcache`以用户`memcache`运行命令。
# 若省略此部分，命令将以root用户运行。
exec 2>&1 chpst -u memcache /usr/bin/memcached

### 在Dockerfile中：
RUN mkdir /etc/service/memcached
ADD memcached.sh /etc/service/memcached/run

注意：shell脚本必须不后台运行/不fork守护进程。通常守护进程会提供命令行参数或配置选项实现此功能。

容器启动时运行脚本

可在容器启动时运行自定义脚本，只需将脚本添加到/docker-entrypoint-init.d/目录。脚本按字典序执行，且必须正常退出（如退出码0），若任一脚本退出码非零，启动将失败。

以下示例添加一个启动脚本，将启动时间记录到/tmp/boottime.txt：

#!/bin/sh
### 在logtime.sh中（确保文件权限为chmod +x）：
date > /tmp/boottime.txt

### 在Dockerfile中：
ADD logtime.sh /docker-entrypoint-init.d/logtime.sh

Nginx配置

Nginx配置设计灵活且易于自定义，默认主配置文件位于rootfs/etc/nginx/nginx.conf。

添加自定义配置

有两种方式添加自定义配置：

1. 全局配置：将配置文件放置在/etc/nginx/conf.d/，全局生效，影响所有服务器块。

2. 服务器特定配置：针对特定服务器块的配置，放置在/etc/nginx/server-conf.d/，仅在该服务器块内生效，实现更精细的控制。

示例

要添加自定义配置，在相应目录创建.conf文件。例如，创建/etc/nginx/server-conf.d/custom-server.conf添加服务器特定规则：

nginx
# 示例自定义服务器配置
location /custom {
    return 200 '自定义服务器配置生效！';
    add_header Content-Type text/plain;
}

此设置允许无需修改主nginx.conf即可管理和自定义Nginx配置。在rootfs/etc/可找到Nginx、PHP和PHP-FPM的默认配置文件。若需扩展或自定义，可通过挂载配置文件实现：

Nginx配置：

docker run -v "`pwd`/nginx-server.conf:/etc/nginx/conf.d/server.conf" erseco/alpine-php-webserver

PHP配置：

docker run -v "`pwd`/php-setting.ini:/etc/php8/conf.d/settings.ini" erseco/alpine-php-webserver

PHP-FPM配置：

docker run -v "`pwd`/php-fpm-settings.conf:/etc/php8/php-fpm.d/server.conf" erseco/alpine-php-webserver

注意：由于-v需要绝对路径，示例中使用pwd获取当前目录的绝对路径。

环境变量

可通过以下环境变量修改NGINX和PHP的配置值：

添加Composer

若项目需要Composer，可通过以下方式添加：

dockerfile
FROM erseco/alpine-php-webserver:latest
USER root
# 从官方镜像安装Composer
RUN apk add --no-cache composer
USER nobody
# 运行composer install安装依赖
RUN composer install --optimize-autoloader --no-interaction --no-progress

使用Composer构建

若构建包含源代码且使用Composer管理依赖的镜像，建议在构建过程中安装依赖。虽然需要Composer（/usr/bin/composer）安装依赖，但生产环境镜像中无需保留，可在安装后卸载以减小镜像大小：

Dockerfile
FROM erseco/alpine-php-webserver

# 切换到root用户安装Composer
USER root

# 安装Composer及所需工具
RUN apk add --no-cache composer

# 复制应用源代码
COPY ./ /var/www/html
WORKDIR /var/www/html

# 切换到非root用户运行Composer
USER nobody

# 安装PHP依赖（需composer.json）
RUN composer install \
    --no-dev \
    --optimize-autoloader \
    --no-interaction \
    --no-progress

# 可选：卸载Composer减小镜像大小
USER root
RUN apk del composer
USER nobody

此方式保持最终镜像简洁，减小体积，并减少生产环境中可能被滥用的工具。

以root用户运行命令

某些情况下可能需要在容器中以root用户运行命令（如安装额外包），可使用docker compose exec配合--user root选项：

bash
docker compose exec --user root alpine-php-webserver sh