karbowiak/docker-php

karbowiak/docker-php 镜像文档

镜像概述和主要用途

这些镜像主要用于Devspace开发环境，同时也适用于其他场景。基于Ubuntu 20.04构建，使用Ondrej的PHP和Nginx PPA源获取最新版本：

• PHP PPA: [***]
• Nginx PPA: [***]

注意事项

镜像每周自动重建一次，确保组件为最新版本。

镜像类型

针对每个PHP版本，提供四种镜像类型，满足不同场景需求。

支持的PHP版本

• 5.6
• 7.0
• 7.1
• 7.2
• 7.3
• 7.4
• 8.0
• 8.1

纯PHP镜像

基础PHP环境，镜像标签格式：karbowiak/docker-php:php<php version>

PHP + Xdebug镜像

包含Xdebug调试工具的PHP环境，镜像标签格式：karbowiak/docker-php:php<php version>-xdebug

PHP + Nginx + FPM镜像

集成Nginx和FPM的PHP环境，镜像标签格式：karbowiak/docker-php:php<php version>-nginx-fpm

PHP + Xdebug + Nginx + FPM镜像

集成Nginx、FPM和Xdebug的完整环境，镜像标签格式：karbowiak/docker-php:php<php version>-xdebug-nginx-fpm

示例：获取PHP 5.6带Xdebug、Nginx和FPM的镜像：karbowiak/docker-php:php5.6-xdebug-nginx-fpm（将<php version>替换为具体版本号）

包含的额外工具

• MyCLI：MySQL命令行增强工具（[***]
• ZSH + OHMyZSH：提升Shell体验的终端工具（[***]

包含的PHP模块

基础模块：

• readline、cli、common、dev、mbstring、igbinary、apcu、imagick、protobuf、sqlite3、yaml、bcmath、inotify、mysql、mysqlnd、mysqli、mongodb、zip、bz2、gd、msgpack、raphf、intl、zstd、redis、lz4、curl、opcache、xhprof、xml、soap、fpm、gmp

Xdebug版本额外包含：

• xdebug

额外配置

所有版本均包含以下PHP配置优化：

CLI配置

opcache.memory_consumption = 1024
opcache.interned_strings_buffer = 256
opcache.max_accelerated_files = 30000
opcache.validate_timestamps = 1
opcache.enable = 1
opcache.enable_cli = 1

FPM配置

opcache.memory_consumption = 1024
opcache.interned_strings_buffer = 256
opcache.max_accelerated_files = 30000
opcache.validate_timestamps = 1
opcache.enable = 1
opcache.enable_cli = 1

Xdebug配置

xdebug.start_with_request = no
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003
xdebug.mode = develop,debug

自定义配置

修改Nginx配置

将自定义配置文件复制到容器内/etc/nginx目录即可覆盖默认配置。

修改PHP/FPM配置

将自定义配置文件复制到容器内/etc/php/<php version>/目录（需替换<php version>为具体版本）。

修改Supervisor配置

可复制容器内/etc/supervisor/conf.d/supervisord.conf到本地修改后重新挂载，或追加自定义配置。示例配置：

[program:custom]
command=echo 'hello world'
process_name=%(program_name)s_%(process_num)02d
numprocs=1
autostart=true
autorestart=false
startsecs=2
redirect_stderr=true
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0

注意：容器使用Golang版本的supervisord（https://github.com/ochinchina/supervisord%EF%BC%89%EF%BC%8C%E8%80%8C%E9%9D%9E%E6%A0%87%E5%87%86Python%E7%89%88%E6%9C%AC%EF%BC%8C%E5%9B%A0%E5%85%B6%E4%B8%BA%E5%8D%95%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%EF%BC%8C%E6%9B%B4%E8%BD%BB%E9%87%8F%E3%80%82

使用场景与部署示例

使用场景

• 开发环境：推荐php<version>-xdebug或php<version>-xdebug-nginx-fpm版本，集成调试工具
• 生产环境：推荐php<version>或php<version>-nginx-fpm版本，减少调试组件

部署示例

1. 验证PHP版本

bash
docker run --rm karbowiak/docker-php:php8.1 php -v

2. 运行Nginx+FPM服务（映射80端口）

bash
docker run -d -p 80:80 --name php-nginx karbowiak/docker-php:php8.0-nginx-fpm

3. 启动带Xdebug的开发环境

bash
docker run --rm -e XDEBUG_CONFIG="client_host=host.docker.internal" karbowiak/docker-php:php7.4-xdebug php -v