kooldev/php 镜像文档

镜像概述和主要用途

kooldev/php 是基于Alpine的轻量级PHP Docker镜像，专为Laravel应用设计，同时也适用于其他PHP使用场景。该镜像旨在配合 kool.dev 使用，提供精简高效的运行环境。包含Nginx的镜像版本默认集成了 h5bp/server-configs-nginx（HTML5 Boilerplate的Nginx服务器配置），可通过 include h5bp/... 灵活调整服务器配置。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多版本支持：提供PHP 8.4、8.3、8.2、8.1等稳定版本，及8.0、7.4等旧版本
• 环境区分：每个PHP版本均提供开发环境（如8.4）和生产环境（如8.4-prod）标签
• Nginx集成：包含带Nginx的版本（如8.4-nginx、8.4-nginx-prod），预配置优化的服务器规则
• Composer支持：默认内置Composer 2.x，同时提供composer1命令支持Composer 1.x（用于过渡期升级）
• 灵活配置：通过环境变量自定义PHP和Nginx参数，如内存限制、时区、端口等

可用标签

镜像地址：kooldev/php，提供以下标签：

8.4

• 8.4 和 8.4-prod
• 8.4-nginx 和 8.4-nginx-prod

8.3

• 8.3 和 8.3-prod
• 8.3-nginx 和 8.3-nginx-prod

8.2

• 8.2 和 8.2-prod
• 8.2-nginx 和 8.2-nginx-prod

8.1

• 8.1 和 8.1-prod
• 8.1-nginx 和 8.1-nginx-prod

旧版本

• 8.0、8.0-prod、8.0-nginx、8.0-nginx-prod
• 7.4、7.4-prod、7.4-nginx、7.4-nginx-prod

扩展版本

针对特定场景，提供以下扩展镜像：

• Oracle OCI8数据库
• MS SQL Server sqlsrv数据库
• Swoole

环境变量

PHP环境变量

NGINX环境变量

使用方法

基础示例

![演示动画]([***]

关于 composer

所有镜像默认内置Composer 2.x。若需使用Composer 1.x（过渡期升级），可通过composer1命令调用最新的Composer 1.x版本。

使用 docker run

简单示例：

sh
docker run -it --rm kooldev/php:7.4 php -v

带环境变量示例（启用Xdebug）：

sh
docker run -it --rm -e ENABLE_XDEBUG=true kooldev/php:7.4-prod php -v

使用 docker-compose.yml

yaml
app:
  image: kooldev/php:8.2
  ports:
    - "9773:9773"
  volumes:
    - ".:/app:cached"
    - "$HOME/.ssh/id_rsa:/home/developer/.ssh/id_rsa:cached"
  environment:
    ASUSER: "${$UID}"

贡献指南

通过模板更新镜像

修改配置文件 fwd-template.json 和 template 目录下的基础模板文件后，运行 kool run template 解析模板并生成所有版本的目录和文件。

许可证

MIT许可证。详情参见许可证文件。