milejko/php

PHP Docker镜像

灵活且易于配置的PHP Docker镜像，提供Debian Slim、Ubuntu及极简Alpine基础镜像，每种基础镜像均包含CLI、FPM和Apache三种PHP模式。

Dockerfile源码地址：https://github.com/milejko/php

支持的操作系统：Debian Slim Bookworm、Ubuntu Noble、Ubuntu Jammy、Alpine 3
镜像变体：CLI、PHP-FPM、Apache
活跃支持的PHP版本：8.2、8.3、8.4
旧版本：7.4、8.0、8.1
支持平台：linux/amd64、linux/arm64、linux/arm/v7

核心功能

• 简洁的配置方式：运行时/编排过程中通过环境变量配置（如MEMORY_LIMIT，详见环境变量列表）
• 稳定的安装源：PHP及默认模块通过稳定的Debian/Alpine软件包安装
• 可定制的入口点：实现了"/docker-entrypoint.d/"目录，支持自定义启动脚本
• 内置Composer工具：开箱即可使用Composer
• 易于扩展模块：可通过apt-get install phpX.Y-module（Debian/Ubuntu）或apk add phpXY-module（Alpine）轻松安装其他PHP模块

使用示例

示例1：终端中运行命令

PHP-CLI默认启动PHP交互式shell，也可作为php命令的前端：

bash
docker run docker.xuanyuan.run/milejko/php:8.4-cli -r 'phpinfo();'

运行后终端将显示phpinfo()输出。注意命令中无需显式指定"php"。

运行其他命令（如composer）：

bash
docker run docker.xuanyuan.run/milejko/php:8.4-cli composer

示例2：以网站形式显示phpinfo()

PHP提供内置Web服务器，以下示例创建一个简单的Web服务器：

Dockerfile

dockerfile
FROM docker.xuanyuan.run/milejko/php:8.4-cli
RUN echo "<?php phpinfo();" > /var/www/html/index.php
EXPOSE 8080
CMD [ "php", "-S", "0.0.0.0:8080" ]

构建并运行镜像：

bash
docker build -t phpinfo-http .
docker run --publish 127.0.0.1:8080:8080 docker.xuanyuan.run/phpinfo-http

访问[***]即可在浏览器中查看phpinfo()页面。

示例3：运行常规PHP-FPM服务器

以下示例展示php:8.4-fpm镜像的典型用法：

Dockerfile

dockerfile
FROM docker.xuanyuan.run/milejko/php:8.4-fpm
RUN echo "<?php phpinfo();" > /var/www/html/index.php

构建并运行镜像：

bash
docker build -t phpinfo-fpm .
docker run --env FPM_LOG_LEVEL=debug --publish 127.0.0.1:9000:9000 docker.xuanyuan.run/phpinfo-fpm

PHP-FPM容器已启动并准备接受连接，示例中通过环境变量将FPM_LOG_LEVEL设置为"debug"。

提示：实际使用时需将PHP应用挂载（或复制）到/var/www/html目录，并配合配置了fastcgi_pass 127.0.0.1:9000;的Nginx作为Web服务器。

示例4：运行Apache服务器

以下示例展示php:8.4-apache镜像的典型用法：

Dockerfile

dockerfile
FROM docker.xuanyuan.run/milejko/php:8.4-apache
RUN echo "<?php phpinfo();" > /var/www/html/index.php

构建并运行镜像：

bash
docker build -t phpinfo-apache .
docker run --publish 127.0.0.1:8080:80 docker.xuanyuan.run/phpinfo-apache

Apache容器已启动并准备接受连接，访问[***]即可在浏览器中查看phpinfo()页面。

已安装的PHP模块

amqp
apcu
bcmath
calendar
Core
ctype
curl
date
dom
exif
FFI
fileinfo
filter
ftp
gd
gettext
hash
iconv
igbinary
intl
json
ldap
libxml
mbstring
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
random
readline
redis
Reflection
session
shmop
SimpleXML
sockets
sodium
SPL
sqlite3
standard
sysvmsg
sysvsem
sysvshm
tokenizer
xdebug (默认禁用，见<a href="#环境变量">环境变量</a>)
xml
xmlreader
xmlwriter
xsl
Zend OPcache
zip
zlib

添加更多PHP模块

以下示例演示如何添加Imagick模块：

Debian/Ubuntu Dockerfile

dockerfile
ARG PHP_VERSION=8.4
FROM docker.xuanyuan.run/milejko/php:${PHP_VERSION}-fpm
RUN apt-get update && \
    apt-get install -y php${PHP_VERSION}-imagick

Alpine Dockerfile

dockerfile
FROM docker.xuanyuan.run/milejko/php:8.4-fpm-alpine
RUN apk update && \
    apk add --no-cache php84-pecl-imagick

注意：Alpine使用无点符号的PHP版本号（如php84而非php8.4），部分模块需添加"pecl"前缀。可在https://pkgs.alpinelinux.org/packages查询完整列表。

构建镜像：

bash
docker build -t fpm-with-imagick .

可用环境变量

通过运行时添加--env ENV=value或在编排配置（如docker-compose.yml）中设置来调整这些值。

通用PHP环境变量

WORKDIR=/var/www/html
ALLOW_URL_FOPEN=1
DEFAULT_SOCKET_TIMEOUT=60
DISPLAY_ERRORS=0
DISPLAY_STARTUP_ERRORS=0
ERROR_REPORTING=E_ALL
MAX_EXECUTION_TIME=30
MEMORY_LIMIT=128M
POST_MAX_SIZE=128M
UPLOAD_MAX_FILESIZE=128M
REALPATH_CACHE_SIZE=4096K
REALPATH_CACHE_TTL=120

OPCache环境变量

OPCACHE_ENABLE=1
OPCACHE_CLI_ENABLE=0
OPCACHE_MEMORY_CONSUMPTION=128M
OPCACHE_INTERNED_STRINGS_BUFFER=16
OPCACHE_VALIDATE_TIMESTAMPS=1
OPCACHE_REVALIDATE_FREQ=2
OPCACHE_PRELOAD=
OPCACHE_PRELOAD_USER=
OPCACHE_JIT=off
OPCACHE_JIT_BUFFER_SIZE=0

Xdebug环境变量

XDEBUG_ENABLE=0
XDEBUG_MODE=off

PHP-FPM变体环境变量

FPM_LISTEN_PORT=9000
FPM_LOG_LEVEL=notice
FPM_PM_MAX_CHILDREN=90
FPM_PM_START_SERVERS=10
FPM_PM_MIN_SPARE_SERVERS=4
FPM_PM_MAX_SPARE_SERVERS=16
FPM_PM_MAX_REQUESTS=0

Apache PHP变体环境变量

APACHE_LISTEN_PORT=80
APACHE_SERVER_NAME=localhost
APACHE_TIMEOUT=300
APACHE_KEEPALIVE=On
APACHE_MAX_KEEPALIVE_REQUESTS=100
APACHE_KEEPALIVE_TIMEOUT=5
APACHE_LOG_LEVEL=warn

由https://github.com/milejko开发，祝您使用愉快！