randock/docker-ubuntu-php

Docker Ubuntu PHP 镜像文档

概述

Docker Ubuntu PHP 镜像是基于 Ubuntu 操作系统构建的 PHP 运行环境容器，旨在为 PHP 应用程序提供便捷、一致的部署和运行环境。该镜像整合了稳定的 Ubuntu 系统基础与 PHP 运行时环境，适用于从开发测试到生产部署的全流程场景。

核心功能与特性

系统基础

• 基于 Ubuntu LTS 版本构建，提供长期稳定支持
• 包含 Ubuntu 系统常用工具（如 apt, curl, wget 等），便于环境调试与扩展

PHP 环境

• 预安装 PHP 及常用扩展，包括但不限于：
  • mysqli（MySQL 数据库连接）
  • pdo_mysql（PDO MySQL 驱动）
  • gd（图像处理）
  • curl（HTTP 请求）
  • mbstring（多字节字符串处理）
  • json（JSON 数据处理）
• 支持 PHP 多版本（如 PHP 7.4, 8.0, 8.1 等，具体版本取决于镜像标签）
• 内置 PHP-FPM（FastCGI 进程管理器），可与 Nginx 等 Web 服务器配合使用

灵活性与可定制性

• 支持通过环境变量自定义 PHP 配置（如内存限制、时区等）
• 允许挂载外部 php.ini 文件覆盖默认配置
• 可通过 apt 按需安装额外系统依赖或 PHP 扩展

使用场景

开发环境

• 本地 PHP 应用开发，确保开发环境与生产环境一致性
• 快速搭建多版本 PHP 测试环境，验证应用兼容性

生产环境

• 部署 PHP Web 应用（如 WordPress、Laravel、Symfony 等）
• 作为微服务架构中的 PHP 服务节点

集成场景

• 与 CI/CD 流程集成，实现自动化测试与部署
• 配合 Docker Compose 构建完整应用栈（如 PHP + MySQL + Nginx）

使用方法

基本使用（Docker Run）

运行 PHP 命令行

bash
docker run --rm -v $(pwd):/app docker.xuanyuan.run/ubuntu-php:8.1 php /app/script.php

运行 PHP-FPM 服务（配合 Nginx）

bash
docker run -d \
  --name php-fpm \
  -v $(pwd)/php-code:/var/www/html \
  -e PHP_MEMORY_LIMIT=512M \
  -e PHP_TIMEZONE=Asia/Shanghai \
  docker.xuanyuan.run/ubuntu-php:8.1-fpm

运行带 Apache 的 PHP 环境（直接提供 Web 服务）

bash
docker run -d \
  --name php-apache \
  -p 8080:80 \
  -v $(pwd)/php-code:/var/www/html \
  docker.xuanyuan.run/ubuntu-php:8.1-apache

Docker Compose 配置示例（PHP + MySQL + Nginx）

yaml
version: '3.8'

services:
  php-fpm:
    image: docker.xuanyuan.run/ubuntu-php:8.1-fpm
    volumes:
      - ./php-code:/var/www/html
    environment:
      - PHP_MEMORY_LIMIT=512M
      - PHP_TIMEZONE=Asia/Shanghai
    depends_on:
      - mysql

  nginx:
    image: docker.xuanyuan.run/nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - ./php-code:/var/www/html
    depends_on:
      - php-fpm

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=phpapp
      - MYSQL_USER=phpuser
      - MYSQL_PASSWORD=phppass
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

配置参数与环境变量

自定义 PHP 配置

通过挂载外部 php.ini 文件覆盖默认配置：

bash
docker run -d \
  --name php-custom \
  -v $(pwd)/custom-php.ini:/etc/php/8.1/cli/conf.d/99-custom.ini \
  docker.xuanyuan.run/ubuntu-php:8.1

版本信息

• 镜像标签格式：{PHP_VERSION}-{WEB_SERVER}，如 8.1-fpm（PHP 8.1 + FPM）、7.4-apache（PHP 7.4 + Apache）
• 基础 Ubuntu 版本：通常为最新 LTS 版本（如 Ubuntu 22.04 LTS）

注意事项

• 生产环境建议使用 FPM 版本配合 Nginx，以获得更好的性能
• 敏感配置（如数据库密码）应通过环境变量或外部配置文件注入，避免硬编码在镜像中
• 定期更新镜像以获取系统安全补丁和 PHP 版本更新