jhonoryza/php

PHP多版本Docker镜像文档

镜像概述

本镜像提供了从PHP 5.6到8.0的完整版本支持，集成FPM和CLI模式，预装生产环境配置的php.ini，以及常用扩展与Composer工具，适用于各类PHP应用的开发、测试与生产部署。源代码托管于https://github.com/jhonoryza/docker-php%E3%80%82

核心功能与特性

版本与架构支持

• PHP版本：5.6、7.0、7.1、7.2、7.3、7.4、8.0
• 系统架构：
  • Ubuntu/Debian版本：标签以ubuntu为前缀
  • Alpine版本：标签以alpine为前缀

内置组件

• 同时包含FPM（FastCGI进程管理器）和CLI（命令行接口）模式
• 默认工作目录：/var/www/html
• 预配置用户组：laravel:laravel（UID:GID 1000:1000），适配常见开发环境权限需求
• 生产环境优化的php.ini配置

Composer支持

• 除标签中明确包含composer版本2的镜像外，所有镜像默认集成Composer 1

预装扩展

Ubuntu版本扩展

curl \
git \
zip unzip \
nano \
bcmath \
bz2 \
calendar \
exif \
gd \
intl \
ldap \
memcached \
mysqli \
opcache \
pdo_mysql \
pdo_pgsql \
pcntl \
pgsql \
redis \
soap \
xsl \
zip \
sockets \
pdo_sqlsrv \
sqlsrv

Alpine版本扩展

bcmath \
bz2 \
curl \
exif \
gd \
imagick \
pcntl \
mbstring \
mcrypt \
memcached \
opcache \
pdo \
pdo_mysql \
redis \
xmlrpc \
zip

使用场景

• PHP应用开发与测试（支持多版本兼容性验证）
• Laravel、Symfony等PHP框架的生产部署
• 需要FPM模式的Web服务环境搭建
• 命令行PHP脚本运行（如定时任务、数据处理）

使用方法

拉取镜像

根据PHP版本和系统架构选择标签，格式为：[版本]-[系统前缀]或[版本]-[系统前缀]-composer2（如需Composer 2）

bash
# 拉取PHP 7.4 Ubuntu版本
docker pull jhonoryza/php:7.4-ubuntu

# 拉取PHP 8.0 Alpine版本（Composer 2）
docker pull jhonoryza/php:8.0-alpine-composer2

运行容器

基本运行（FPM模式）

bash
docker run -d \
  -p 9000:9000 \
  -v /path/to/your/php/app:/var/www/html \
  --name php-app \
  jhonoryza/php:7.4-ubuntu

命令行模式（CLI）

bash
docker run --rm \
  -v /path/to/your/php/app:/var/www/html \
  jhonoryza/php:7.4-ubuntu \
  php artisan migrate  # Laravel迁移示例

Docker Compose配置示例

yaml
version: '3'
services:
  php:
    image: jhonoryza/php:8.0-ubuntu
    volumes:
      - ./app:/var/www/html
    ports:
      - "9000:9000"
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d
    networks:
      - app-network

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
      - ./nginx/conf.d:/etc/nginx/conf.d
    depends_on:
      - php
    networks:
      - app-network

networks:
  app-network:

配置说明

工作目录

默认工作目录为/var/www/html，建议将应用代码挂载到此路径以确保PHP进程可访问。

用户权限

镜像内置laravel:laravel用户（UID:GID 1000:1000），可通过--user参数指定运行用户：

bash
docker run -d \
  --user laravel \
  -v /path/to/app:/var/www/html \
  jhonoryza/php:7.4-ubuntu

php.ini配置

生产环境php.ini已预配置，如需自定义可通过挂载配置文件覆盖：

bash
docker run -d \
  -v /path/to/custom/php.ini:/usr/local/etc/php/php.ini \
  jhonoryza/php:7.4-ubuntu

扩展管理

如需额外安装PHP扩展，可通过容器内命令（需root权限）：

bash
# 进入容器
docker exec -it --user root php-app bash

# Ubuntu版本安装扩展
install-php-extensions [扩展名称]

# Alpine版本安装扩展（需使用apk）
apk add --no-cache [扩展依赖包] && docker-php-ext-install [扩展名称]