jrcs/php

PHP Docker化镜像文档

镜像概述和主要用途

该镜像是一个预配置的Docker化PHP运行环境，集成了PHP解释器、常用扩展及Web服务器（Apache/Nginx），旨在简化PHP应用的部署流程。无需手动配置PHP依赖、扩展及Web服务，可直接用于开发、测试及生产环境的PHP应用部署，帮助开发者和运维人员快速搭建一致的运行环境。

核心功能和特性

• 预配置环境：包含PHP解释器、Web服务器（Apache默认集成）及常用扩展（mysqli、pdo_mysql、gd、curl、mbstring等）
• 版本支持：提供多PHP版本标签（如7.4、8.0、8.1等），满足不同应用兼容性需求
• 轻量级设计：基于Alpine或Debian Slim基础镜像构建，减少镜像体积，提升部署效率
• 灵活定制：支持通过环境变量、配置文件挂载自定义PHP设置及扩展
• 即开即用：拉取镜像后无需额外配置，可直接运行PHP脚本或Web应用

使用场景和适用范围

• 开发环境：本地PHP应用开发、多版本PHP测试、团队协作环境统一
• 生产部署：中小型PHP应用（如WordPress、Laravel、ThinkPHP等框架应用）的快速部署
• CI/CD集成：作为自动化测试、构建流程中的运行环境，执行代码检查和单元测试
• 教学演示：PHP语法教学、Web开发入门演示的简易环境搭建

使用方法和配置说明

基础使用（Docker Run）

1. 运行PHP脚本

bash
# 执行单个PHP脚本
docker run --rm -v $(pwd):/app -w /app php-dockerized:8.1 php script.php

# 启动交互式PHP终端
docker run --rm -it php-dockerized:8.1 php -a

2. 运行Web应用

bash
# 挂载应用代码并启动Web服务（默认Apache，映射80端口）
docker run -d -p 8080:80 -v $(pwd)/app:/var/www/html --name php-web-app php-dockerized:8.1

访问 http://localhost:8080 即可查看运行的PHP Web应用

Docker Compose配置示例

yaml
version: '3.8'
services:
  php-app:
    image: php-dockerized:8.1
    ports:
      - "8080:80"
    volumes:
      - ./app:/var/www/html  # 挂载本地PHP应用代码
      - ./php-conf:/usr/local/etc/php/conf.d  # 挂载自定义PHP配置
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d  # 自定义配置扫描目录
      - APACHE_DOCUMENT_ROOT=/var/www/html/public  # 设置应用根目录（如Laravel的public目录）
    depends_on:
      - mysql  # 可选：关联数据库服务

  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=php_app_db

配置参数与环境变量

自定义PHP配置

1. 挂载配置文件

创建自定义php.ini或*.ini配置文件，通过卷挂载到容器配置目录：

bash
docker run -d -p 8080:80 \
  -v $(pwd)/app:/var/www/html \
  -v $(pwd)/custom-php.ini:/usr/local/etc/php/conf.d/custom.ini \
  php-dockerized:8.1

2. 安装额外扩展

通过Dockerfile基于此镜像构建，添加所需扩展：

dockerfile
FROM php-dockerized:8.1
# 安装soap扩展示例
RUN docker-php-ext-install soap
# 安装pecl扩展示例
RUN pecl install redis && docker-php-ext-enable redis

注意事项

• 生产环境建议：配合反向代理（如Nginx）使用，增强安全防护和静态资源处理能力
• 敏感信息管理：数据库密码等敏感配置通过环境变量或Docker Secrets传递，避免硬编码
• 版本选择：根据应用兼容性选择PHP版本标签，生产环境优先使用LTS版本
• 安全更新：定期拉取最新镜像以获取PHP安全补丁和扩展更新
• 资源限制：生产部署时通过--memory、--cpus参数限制容器资源占用，避免资源耗尽