bearstech PHP Docker镜像文档

镜像概述

bearstech PHP Docker镜像是基于Debian系统和Sury源（[***]

核心功能与特性

• 多版本支持：提供7.3(buster)、7.4(bullseye)、8.2(bookworm)稳定版本，以及8.x-rr(bookworm + Sury)滚动发布版本，满足不同应用的PHP版本需求。
• 灵活用户管理：支持通过构建参数自定义用户UID，解决容器与宿主机卷挂载的权限问题。
• 自定义启动脚本：可在/entrypoint.d/目录添加脚本，entrypoint会通过run-parts自动按顺序执行，便于初始化配置。
• 环境变量配置：通过环境变量可直接覆盖PHP FPM池核心参数，无需手动修改配置文件。

使用方法

构建自定义镜像

基于本镜像构建应用镜像时，建议创建专用用户以确保权限兼容。示例Dockerfile如下：

dockerfile
FROM bearstech/php:8.2
ARG UID=1001
RUN useradd php-worker --uid ${UID} --shell /bin/bash
USER php-worker

注意：构建时通过--build-arg UID=$(id -u)传递当前用户UID（如docker build --build-arg UID=$(id -u) -t my-php-app .），可避免容器内文件权限与宿主机冲突。

启动脚本扩展

如需在容器启动前执行自定义初始化操作，可将脚本添加至/entrypoint.d/目录。entrypoint进程会通过run-parts自动执行该目录下的所有可执行脚本。

环境变量配置

所有环境变量均为可选，但设置后会覆盖PHP FPM池默认配置，变量说明如下：

示例：启动容器时设置PHP工作进程数和内存限制

bash
docker run -d \
  -e WORKERS=10 \
  -e MEMORYLIMIT=256M \
  bearstech/php:8.2