mikeydzj/php-builder

PHP项目Docker镜像文档

镜像概述

本镜像专为PHP项目设计，提供运行PHP应用所需的完整基础环境，包含PHP运行时、常用扩展及系统依赖。旨在简化PHP应用的部署流程，确保应用在开发、测试和生产环境中具备一致的运行行为。

核心功能和特性

• 预安装常用扩展：包含mysqli、pdo_mysql、gd、curl、json等开发和生产环境必备PHP扩展，满足多数PHP应用需求。
• 多版本支持：提供多个PHP版本标签（如7.4、8.0、8.1等），可根据项目兼容性需求选择对应版本。
• 轻量级设计：基于官方PHP镜像优化，去除冗余依赖，降低镜像体积，提升运行效率。
• 灵活配置：支持通过环境变量或配置文件自定义PHP核心参数（如memory_limit、upload_max_filesize等）。
• 兼容性强：兼容Nginx、Apache等主流Web服务器，可作为FastCGI服务与前端服务器配合使用。

使用场景和适用范围

• 开发环境：快速搭建本地PHP开发环境，避免因本地配置差异导致的兼容性问题。
• 测试环境：在CI/CD流程中作为标准化测试环境，确保代码在统一环境中验证。
• 生产环境：部署中小型PHP应用、网站、API服务，支持单机或集群部署模式。
• 适用项目类型：个人博客、企业官网、电商平台、PHP框架应用（如Laravel、ThinkPHP、Yii）等。

使用方法和配置说明

基本运行

通过以下命令启动PHP容器，运行当前目录下的PHP应用：

bash
docker run -d -p 8080:80 -v $(pwd):/var/www/html --name php-app [镜像名称]:[版本标签]

参数说明：

• -v $(pwd):/var/www/html：将本地项目目录挂载到容器内默认Web根目录
• -p 8080:80：将容器80端口映射到主机8080端口，用于访问应用
• --name php-app：指定容器名称，便于后续管理

自定义PHP配置

通过环境变量配置

支持通过PHP_INI_*前缀的环境变量自定义PHP配置，示例：

bash
docker run -d \
  -e PHP_INI_memory_limit=256M \
  -e PHP_INI_upload_max_filesize=10M \
  -e PHP_INI_post_max_size=12M \
  -v $(pwd):/var/www/html \
  --name php-app [镜像名称]:[版本标签]

上述命令将PHP内存限制设为256M，上传文件大小限制设为10M，POST数据大小限制设为12M。

通过配置文件挂载

将本地自定义php.ini挂载到容器PHP配置目录：

bash
docker run -d \
  -v $(pwd)/php.ini:/usr/local/etc/php/php.ini \
  -v $(pwd):/var/www/html \
  --name php-app [镜像名称]:[版本标签]

与Web服务器配合使用

Docker Compose示例（PHP+Nginx）

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

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

  php:
    image: [镜像名称]:[版本标签]
    volumes:
      - ./project:/var/www/html
    environment:
      - PHP_INI_memory_limit=512M

创建Nginx配置文件nginx.conf：

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

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

启动服务：

bash
docker-compose up -d

安装额外扩展

如需安装镜像未预包含的PHP扩展，可通过容器内docker-php-ext-install命令：

bash
# 进入运行中的容器
docker exec -it php-app bash

# 安装扩展（以redis为例）
docker-php-ext-install redis

# 重启容器使扩展生效
docker restart php-app

注意事项

• 生产环境建议使用特定版本标签（如8.1.20）而非latest，确保环境稳定性
• 敏感配置（如数据库密码）建议通过环境变量注入，避免硬编码在镜像或配置文件中
• 高并发场景下，建议结合负载均衡（如Nginx反向代理）和容器编排工具（如Kubernetes）使用
• 定期更新镜像版本以获取安全补丁和功能更新