nicoherbigde/php

PHP Docker镜像文档

概述

PHP Docker镜像是官方提供的容器化PHP运行时环境，基于轻量级基础镜像构建，包含预配置的PHP解释器及常用扩展。该镜像支持多种PHP版本（5.6+、7.x、8.x系列）和部署模式（CLI、Apache、FPM），可快速集成到开发、测试和生产环境，简化PHP应用的环境配置与部署流程。

核心功能和特性

多版本与部署模式支持

• PHP版本覆盖：支持PHP 5.6、7.0-7.4、8.0-8.3等主流版本，标签格式如php:8.3-cli、php:7.4-fpm
• 部署模式：提供多种变体满足不同场景需求
  • php:<version>：基础CLI版本，适用于命令行脚本
  • php:<version>-apache：集成Apache服务器，直接提供Web服务
  • php:<version>-fpm：FastCGI进程管理器，需配合Nginx等反向代理使用
  • php:<version>-alpine：基于Alpine Linux的轻量级版本（体积更小）

扩展与配置灵活性

• 内置扩展管理工具：通过docker-php-ext-configure、docker-php-ext-install、docker-php-ext-enable命令快速安装/启用扩展（如pdo_mysql、mbstring、gd等）
• 自定义配置：支持通过挂载php.ini文件或在Dockerfile中添加配置指令覆盖默认PHP配置
• 多平台支持：适配amd64、arm64等架构，满足不同硬件环境需求

轻量与安全

• 基础镜像优化：默认使用Debian slim镜像，Alpine变体进一步减少体积（比标准版本小50%以上）
• 安全更新：官方定期更新基础镜像和PHP版本，修复已知安全漏洞

使用场景和适用范围

• 开发环境：快速搭建隔离的PHP开发环境，避免本地环境配置冲突
• 生产部署：作为PHP应用的运行时容器，配合负载均衡实现高可用
• CI/CD集成：在自动化测试流程中作为PHP运行环境，验证代码兼容性
• 微服务架构：作为PHP微服务的基础容器，与其他服务（如数据库、缓存）协同工作
• 教学与演示：快速展示PHP代码运行效果，无需本地安装PHP环境

使用方法和配置说明

基本使用（CLI模式）

运行PHP脚本文件：

bash
# 挂载当前目录到容器/app目录，执行脚本
docker run --rm -v $(pwd):/app php:latest php /app/your_script.php

Web服务部署（Apache集成）

使用php:apache变体直接提供Web服务：

bash
# 将当前目录作为网站根目录，映射80端口到本地8080
docker run -d -p 8080:80 -v $(pwd):/var/www/html --name php-apache php:apache

访问http://localhost:8080即可查看网站内容（需确保当前目录有index.php文件）。

Web服务部署（FPM+Nginx）

使用php:fpm配合Nginx反向代理（推荐生产环境）：

1. 创建docker-compose.yml：

yaml
version: '3'
services:
  php-fpm:
    image: php:8.3-fpm
    volumes:
      - ./php-app:/var/www/html
    restart: always

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

2. 创建Nginx配置文件nginx.conf：

nginx
server {
    listen 80;
    root /var/www/html;
    index index.php index.html;

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3. 启动服务：

bash
docker-compose up -d

扩展安装

通过docker-php-ext-install安装PHP扩展（需在Dockerfile中或容器内执行）：

1. 创建自定义Dockerfile：

dockerfile
FROM php:8.3-fpm

# 安装pdo_mysql和gd扩展
RUN docker-php-ext-install pdo_mysql gd

# 安装需要额外依赖的扩展（如imagick）
RUN apt-get update && apt-get install -y libmagickwand-dev \
    && pecl install imagick \
    && docker-php-ext-enable imagick

2. 构建并使用自定义镜像：

bash
docker build -t my-php-app .
docker run --rm my-php-app php -m | grep pdo_mysql  # 验证扩展是否安装成功

配置PHP.ini

通过挂载自定义php.ini覆盖默认配置：

bash
# 创建自定义php.ini（可从容器内复制默认配置修改）
docker run --rm php:latest cat /usr/local/etc/php/php.ini-production > php.ini
# 编辑php.ini后挂载使用
docker run --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini php:latest php -i | grep upload_max_filesize

版本选择建议

• 开发环境：使用php:latest或特定版本（如php:8.3-cli）快速验证
• 生产环境：使用具体版本标签（如php:8.3.4-fpm-alpine）确保环境一致性，优先选择Alpine变体减小镜像体积
• 兼容性测试：使用多版本标签（如php:7.4-cli, php:8.0-cli）验证应用在不同PHP版本的兼容性