kooldev/php

kooldev/php 镜像文档

镜像概述和主要用途

kooldev/php 是基于Alpine的轻量级PHP Docker镜像，专为Laravel应用设计，同时也适用于其他PHP使用场景。该镜像旨在配合 https://github.com/kool-dev/kool 使用，提供精简高效的运行环境。包含Nginx的镜像版本默认集成了 https://github.com/h5bp/server-configs-nginx%EF%BC%88HTML5 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参数，如内存限制、时区、端口等

可用标签

镜像地址：https://hub.docker.com/r/kooldev/php/tags?page=1&ordering=last_updated%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BB%A5%E4%B8%8B%E6%A0%87%E7%AD%BE%EF%BC%9A

8.4

• https://github.com/kool-dev/docker-php/blob/master/8.4/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.4-prod/Dockerfile
• https://github.com/kool-dev/docker-php/blob/master/8.4-nginx/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.4-nginx-prod/Dockerfile

8.3

• https://github.com/kool-dev/docker-php/blob/master/8.3/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.3-prod/Dockerfile
• https://github.com/kool-dev/docker-php/blob/master/8.3-nginx/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.3-nginx-prod/Dockerfile

8.2

• https://github.com/kool-dev/docker-php/blob/master/8.2/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.2-prod/Dockerfile
• https://github.com/kool-dev/docker-php/blob/master/8.2-nginx/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.2-nginx-prod/Dockerfile

8.1

• https://github.com/kool-dev/docker-php/blob/master/8.1/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.1-prod/Dockerfile
• https://github.com/kool-dev/docker-php/blob/master/8.1-nginx/Dockerfile 和 https://github.com/kool-dev/docker-php/blob/master/8.1-nginx-prod/Dockerfile

旧版本

• https://github.com/kool-dev/docker-php/blob/master/8.0/Dockerfile%E3%80%81https://github.com/kool-dev/docker-php/blob/master/8.0-prod/Dockerfile%E3%80%81https://github.com/kool-dev/docker-php/blob/master/8.0-nginx/Dockerfile%E3%80%81https://github.com/kool-dev/docker-php/blob/master/8.0-nginx-prod/Dockerfile
• https://github.com/kool-dev/docker-php/blob/master/7.4/Dockerfile%E3%80%81https://github.com/kool-dev/docker-php/blob/master/7.4-prod/Dockerfile%E3%80%81https://github.com/kool-dev/docker-php/blob/master/7.4-nginx/Dockerfile%E3%80%81https://github.com/kool-dev/docker-php/blob/master/7.4-nginx-prod/Dockerfile

扩展版本

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

• https://github.com/kool-dev/docker-php-oci8
• https://github.com/kool-dev/docker-php-sqlsrv
• https://github.com/kool-dev/docker-php-swoole

环境变量

PHP环境变量

NGINX环境变量

使用方法

基础示例

https://asciinema.org/a/388121.svg](https://asciinema.org/a/388121)%EF%BC%88%E7%82%B9%E5%87%BB%E6%9F%A5%E7%9C%8B%E4%BD%BF%E7%94%A8%E6%BC%94%E7%A4%BA%EF%BC%89

关于 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许可证。详情参见许可证文件。