fduarte42/docker-php

PHP容器镜像文档

1. 镜像概述

PHP容器镜像是预构建的Docker镜像，集成PHP运行时环境及其依赖组件，旨在简化PHP应用的部署与运行流程。支持多种稳定PHP版本（如7.4、8.0、8.1、8.2等），提供不同变体（CLI、FPM、Apache）以适配不同应用场景，可直接用于开发、测试和生产环境。

2. 核心功能与特性

2.1 多版本与变体支持

• 提供多种PHP主版本（7.4+）及次版本镜像，满足不同应用兼容性需求
• 包含多种运行变体：
  • CLI：命令行接口，适用于脚本执行、定时任务
  • FPM：FastCGI进程管理器，适合与Nginx配合部署Web应用
  • Apache：集成Apache服务器，开箱即可运行PHP Web应用

2.2 内置常用扩展

预安装PHP开发常用扩展，包括：

• 数据库：mysqli、pdo_mysql、pdo_pgsql
• 图形处理：gd、imagick（部分版本）
• 网络与加密：curl、openssl、mbstring
• 数据处理：json、xml、zip、redis（部分版本）

2.3 灵活的扩展管理

通过官方提供的工具脚本自定义扩展：

• docker-php-ext-install：安装并启用扩展
• docker-php-ext-enable：启用已安装的扩展
• docker-php-ext-configure：配置扩展编译参数

2.4 环境配置优化

• 支持通过挂载php.ini文件自定义PHP配置
• 可通过环境变量调整核心配置参数（内存限制、执行时间等）
• 轻量级基础镜像（Alpine/Debian），平衡性能与安全性

3. 使用场景

3.1 开发环境

快速搭建统一的本地开发环境，通过目录挂载实现代码实时更新与测试，避免环境差异导致的"在我电脑上能运行"问题。

3.2 自动化测试

在CI/CD流程中作为测试环境，快速部署应用并执行单元测试、集成测试，确保代码质量。

3.3 生产部署

配合容器编排工具（Kubernetes/Docker Compose）实现规模化部署，支持负载均衡、滚动更新等生产级特性。

4. 使用方法

4.1 获取镜像

从Docker Hub拉取指定版本镜像：

bash
# 格式：docker pull docker.xuanyuan.run/php:[版本]-[变体]
# 示例：拉取PHP 8.1 FPM版本
docker pull docker.xuanyuan.run/php:8.1-fpm

4.2 基本使用示例

4.2.1 运行PHP脚本（CLI模式）

bash
# 将当前目录挂载到容器内/app，执行脚本
docker run --rm -v $(pwd):/app docker.xuanyuan.run/php:8.1-cli php /app/script.php

4.2.2 部署Web应用（Nginx+FPM）

使用Docker Compose编排Nginx与PHP-FPM服务：

目录结构

project/
├── docker-compose.yml
├── nginx/
│   └── default.conf  # Nginx配置
└── src/              # PHP应用代码
    └── index.php

Nginx配置（nginx/default.conf）

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

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

docker-compose.yml配置

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
      - ./src:/var/www/html
    depends_on:
      - php-fpm

  php-fpm:
    image: docker.xuanyuan.run/php:8.1-fpm
    volumes:
      - ./src:/var/www/html

启动服务

bash
docker-compose up -d

访问http://localhost即可查看PHP应用。

4.3 自定义PHP配置

4.3.1 挂载自定义php.ini

bash
# 创建自定义php.ini，挂载到容器配置目录
docker run --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini docker.xuanyuan.run/php:8.1-cli php -i | grep "Loaded Configuration File"

4.4 安装额外扩展

示例：安装gd扩展（需先安装系统依赖）

bash
docker run --rm -it docker.xuanyuan.run/php:8.1-cli bash
# 容器内执行
apt-get update && apt-get install -y libfreetype6-dev libjpeg62-turbo-dev libpng-dev
docker-php-ext-configure gd --with-freetype --with-jpeg
docker-php-ext-install -j$(nproc) gd
# 验证安装
php -m | grep gd

5. 环境变量说明

6. 注意事项

• 版本控制：生产环境建议使用具体版本标签（如php:8.1.20-fpm），避免latest标签导致版本不可控
• 安全加固：使用非root用户运行容器，限制容器权限；避免在镜像中存储敏感信息
• 性能优化：根据应用需求调整FPM进程数、内存限制等参数；生产环境建议启用OPcache
• 更新策略：定期更新镜像以获取安全补丁和功能更新