prog/php

PHP应用基础Docker镜像

基于Alpine Linux的Docker镜像，集成Apache（prefork模式）和PHP模块，为PHP应用提供轻量、可扩展的运行环境。

支持的标签/版本

镜像标签由镜像版本、PHP版本、Apache版本和Alpine版本组成，部分版本号可省略以支持语义化版本控制。

最新版本

• prog/php:0.1[.2]--php7[.1]-apache[2[.4]]-alpine[3[.6]]
  ![]([***]
• prog/php:0.1[.2]--php5[.6]-apache[2[.4]]-alpine[3[.6]]
  ![]([***]
• https://github.com/prog/docker-php/releases

核心功能

1. 轻量基础：基于Alpine Linux，镜像体积小，资源占用低。
2. 灵活自定义：提供辅助脚本，支持安装PHP模块、配置PHP参数、启用Apache模块等。
3. 初始化支持：允许添加容器启动前的自定义初始化逻辑。

使用场景

适用于部署各类PHP Web应用，如博客系统（WordPress）、内容管理系统（Drupal）、框架应用（Laravel、Symfony）等。

配置说明

安装PHP模块

镜像默认无额外PHP模块，通过以下脚本安装所需模块：

bash
image--php-add-mod [模块列表]

示例Dockerfile指令：

Dockerfile
RUN image--php-add-mod cli gd mbstring pdo session ...  

修改PHP配置

向php.ini添加配置指令：

bash
image--php-config [配置指令]

示例Dockerfile指令：

Dockerfile
RUN image--php-config \
    expose_php=Off \
    max_execution_time=10 \
    memory_limit=32M \
    post_max_size=20M \
    upload_max_filesize=20M \
    date.timezone="Europe/Bratislava"

启用Apache模块

默认仅启用基础模块，通过脚本启用所需模块：

bash
image--apache-enable-mod [模块列表]

示例Dockerfile指令：

Dockerfile
RUN image--apache-enable-mod deflate filter rewrite ...

修改文档根目录

默认根目录为/app，通过脚本修改：

bash
image--apache-set-docroot [路径]
# 简写
image--set-docroot [路径]

示例Dockerfile指令：

Dockerfile
RUN image--set-docroot /app/public

初始化脚本

容器启动前执行/usr/bin/image--init（默认空），添加自定义指令：

bash
image--on-init [脚本行]

示例Dockerfile指令：

Dockerfile
RUN image--on-init \
   '# 应用初始化' \
   'echo "启动应用！"' \
   'chmod 777 /app/temp'

完整使用示例

Dockerfile配置

Dockerfile
FROM prog/php:0.1--php7-apache-alpine

## 安装PHP模块
RUN image--php-add-mod cli iconv json mbstring pdo_mysql session sqlite3 tokenizer

## 配置PHP参数
RUN image--php-config \
   'expose_php=Off' \
   'max_execution_time=10' \
   'memory_limit=32M' \
   'post_max_size=20M' \
   'upload_max_filesize=20M' \
   'date.timezone="Europe/Bratislava"'

## 启用Apache模块
RUN image--apache-enable-mod deflate filter rewrite

## 设置文档根目录
RUN image--set-docroot /app/public

## 添加初始化脚本
RUN image--on-init \
   'chmod 777 /app/log /app/temp /app/sessions' \
   'if [ "$APP__DB_MIGRATIONS" ]; then' \
   '	/app/bin/db-migrations $APP__DB_MIGRATIONS' \
   'fi'

## 复制应用文件
WORKDIR /app
COPY vendor vendor
COPY bin bin
COPY src src
COPY public public
RUN mkdir log temp sessions

## 声明卷和端口
VOLUME /app/log
VOLUME /app/sessions
EXPOSE 80

构建镜像

bash
docker build . -t my-awesome-app

运行容器

bash
docker run \
  -e 'APP__DB_DSN=mysql:host=localhost;dbname=database' \
  -e 'APP__DB_USER=user' \
  -e 'APP__DB_PASSWORD=password' \
  -e 'APP__DB_MIGRATIONS=main' \
  -e 'APP__DEBUG_MODE=off' \
  -v 'my-awesome-app__log:/app/log' \
  -v 'my_awesome-app__sessions:/app/sessions' \
  -p '80:80' \
  my-awesome-app