PHP Docker镜像文档

镜像概述

PHP Docker镜像是一个预配置的容器化解决方案，包含PHP运行时环境及其核心依赖，旨在简化PHP应用程序的部署与运行。该镜像支持多种PHP版本，提供灵活的配置选项，确保应用在开发、测试和生产环境中的一致性和可移植性。

核心功能与特性

• 多版本支持：提供多种PHP版本（如7.4、8.0、8.1、8.2等），满足不同应用的兼容性需求。
• 扩展管理：内置常用PHP扩展（如mysqli、pdo_mysql、gd、curl等），支持通过配置自定义安装扩展。
• 灵活配置：允许通过挂载配置文件（如php.ini）或设置环境变量调整PHP运行参数。
• 轻量级选项：提供基于Alpine Linux的精简版本，减少镜像体积；同时提供基于Debian的完整版本，确保兼容性。
• 生产就绪：支持与Nginx、Apache等Web服务器配合使用，适用于生产环境部署。

使用场景与适用范围

• Web应用部署：快速部署PHP Web应用（如WordPress、Laravel、Symfony、Drupal等）。
• 开发环境一致性：统一开发团队的PHP环境，避免因环境差异导致的"在我电脑上能运行"问题。
• CI/CD集成：作为持续集成/持续部署流程的一部分，用于自动化测试和构建验证。
• 微服务架构：作为PHP微服务的运行容器，与数据库、缓存等服务协同工作。

使用方法与配置说明

基本使用（Docker Run）

运行PHP交互式shell

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

执行PHP脚本

将本地PHP脚本挂载到容器中执行：

bash
docker run --rm -v $(pwd):/app -w /app php:latest php your_script.php

与Web服务器配合使用（Nginx+PHP-FPM示例）

创建docker-compose.yml配置文件：

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

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

创建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;
    }
}

启动服务：

bash
docker-compose up -d

自定义PHP扩展

临时安装扩展（Debian基础镜像）

使用***提供的docker-php-ext-install工具安装扩展：

bash
docker run --rm php:8.2-fpm docker-php-ext-install pdo_mysql gd

构建包含自定义扩展的镜像（Dockerfile示例）

dockerfile
FROM php:8.2-fpm

# 安装依赖并配置扩展
RUN apt-get update && apt-get install -y \
    libpng-dev \
    libjpeg-dev \
    && docker-php-ext-configure gd --with-jpeg \
    && docker-php-ext-install pdo_mysql gd

# 复制自定义php.ini配置
COPY php.ini /usr/local/etc/php/

构建并使用自定义镜像：

bash
docker build -t my-php-image .
docker run --rm my-php-image php -m | grep gd  # 验证扩展是否安装

环境变量与配置参数

版本选择

镜像标签格式：php:<version>-<variant>，常用变体说明：

• php:8.2：基于Debian的PHP 8.2版本（默认包含CLI）
• php:8.2-fpm：包含PHP-FPM（FastCGI进程管理器）
• php:8.2-alpine：基于Alpine Linux的精简版本
• php:8.2-cli：仅包含PHP命令行接口

注意事项

• 生产环境建议使用特定版本标签（如php:8.2.10-fpm）而非latest，避免版本自动更新导致兼容性问题。
• Alpine版本镜像体积更小，但部分扩展可能需要手动编译；Debian版本兼容性更好，预装依赖更完整。
• 敏感配置（如数据库密码）应通过环境变量或外部配置文件注入，避免硬编码到镜像中。
• 长时间运行的PHP应用需注意容器资源限制和日志管理，确保稳定性和可维护性。