brainbitsgmbh/php

PHP Docker镜像文档

概述

PHP官方Docker镜像是预配置的标准化PHP运行环境，基于Debian或Alpine Linux构建，旨在简化PHP应用的部署流程。该镜像提供多版本PHP支持、灵活的扩展管理机制和优化的运行配置，可直接用于开发调试、自动化测试或生产环境部署。

核心功能与特性

• 多版本支持：覆盖PHP 5.6至最新稳定版（如PHP 8.3），满足不同应用的兼容性需求
• 多样化基础镜像：提供多种变体，包括：
  • debian（默认，功能全面，适合生产环境）
  • alpine（轻量级，体积小，适合资源受限场景）
  • slim（精简版Debian基础，平衡体积与功能）
• 扩展管理工具：集成docker-php-ext-install、docker-php-ext-enable等工具，支持一键安装/启用PHP扩展（如mysqli、pdo_mysql、gd、opcache等）
• 运行模式适配：提供CLI（命令行）、FPM（FastCGI进程管理器）等模式，支持与Nginx/Apache等Web服务器协同工作
• 配置灵活性：支持通过挂载自定义php.ini或配置目录覆盖默认PHP配置

使用场景

• 本地开发环境：快速搭建隔离的PHP开发环境，避免系统级依赖冲突
• 生产部署：作为PHP应用的运行容器，配合反向代理实现高可用部署
• CI/CD流程：集成到自动化测试 pipeline，验证代码在不同PHP版本下的兼容性
• 微服务架构：作为PHP微服务的基础运行单元，与数据库、缓存等服务协同工作

使用方法

基本使用示例

1. 运行PHP交互式终端

bash
docker run -it --rm php:latest php -a

--rm 确保容器退出后自动清理，适合临时测试

2. 运行本地PHP脚本

将当前目录挂载到容器内并执行脚本：

bash
docker run -it --rm -v "$PWD":/app -w /app php:8.2-cli php your_script.php

• -v "$PWD":/app：挂载当前目录到容器内/app目录
• -w /app：设置工作目录为/app

3. 配合Nginx部署Web应用（Docker Compose）

创建docker-compose.yml：

yaml
version: '3.8'
services:
  php-fpm:
    image: php:8.2-fpm-alpine
    volumes:
      - ./app:/var/www/html  # 挂载PHP应用代码
      - ./php.ini:/usr/local/etc/php/php.ini  # 自定义PHP配置
    restart: always

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # Nginx配置
    depends_on:
      - php-fpm
    restart: always

安装PHP扩展

通过docker-php-ext-install安装内置扩展：

dockerfile
# 构建自定义镜像示例（Dockerfile）
FROM php:8.2-fpm-alpine

# 安装基础依赖（Alpine需使用apk包管理器）
RUN apk add --no-cache libpng-dev libjpeg-turbo-dev freetype-dev \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd pdo_mysql mysqli opcache

安装PECL扩展（如Redis）：

dockerfile
FROM php:8.2-cli
RUN pecl install redis-5.3.7 && docker-php-ext-enable redis

配置管理

自定义php.ini

挂载外部配置文件覆盖默认设置：

bash
docker run -d --name php-app \
  -v ./custom-php.ini:/usr/local/etc/php/php.ini \
  -v ./app:/var/www/html \
  php:8.2-fpm

扩展配置目录

通过挂载conf.d目录添加扩展配置：

bash
docker run -d --name php-app \
  -v ./php-conf.d:/usr/local/etc/php/conf.d \
  php:8.2-fpm

容器内默认配置路径：/usr/local/etc/php/php.ini（主配置）和/usr/local/etc/php/conf.d/（扩展配置）

常用版本标签说明

环境变量

生产环境最佳实践

1. 使用固定版本标签：避免使用latest，建议指定完整版本（如php:8.2.15-fpm-alpine3.19）确保部署一致性
2. 优化扩展安装：仅安装应用必需的扩展，减少镜像体积和***面
3. 配置持久化：通过外部挂载管理php.ini和扩展配置，避免配置硬编码
4. 资源限制：设置CPU/内存限制（如--memory=512m --cpus=0.5）防止资源耗尽
5. 健康检查：添加健康检查确保服务可用性：

   bash
   docker run -d --name php-app \
     --health-cmd "php -r 'exit(extension_loaded(\"pdo_mysql\") ? 0 : 1);'" \
     --health-interval=30s \
     --health-timeout=5s \
     php:8.2-fpm
   

注意事项

• Windows/macOS用户使用目录挂载时需确保文件权限兼容（可通过-u $(id -u):$(id -g)指定用户ID）
• Alpine版本部分扩展可能需要手动安装系统依赖（如libpng-dev对应gd扩展）
• 生产环境建议禁用display_errors、启用opcache并优化php-fpm.conf进程配置