ronasit/php-nginx

webdevops/php-nginx 镜像文档

镜像概述

webdevops/php-nginx是一个集成Nginx Web服务器与PHP运行环境的Docker镜像，本变体预装pgsql（PostgreSQL客户端扩展）、sodium（加密扩展）和imagick（图像处理扩展），为需要这些功能的Web应用提供开箱即用的运行环境，简化开发与部署流程。

核心功能与特性

• 集成环境：同时包含Nginx和PHP，无需单独配置Web服务器与PHP解释器
• 扩展支持：
  • pgsql：提供PostgreSQL数据库连接能力，支持数据库查询与操作
  • sodium：实现现代加密算法，支持数据加密、签名验证等安全功能
  • imagick：基于ImageMagick的图像处理扩展，支持格式转换、裁剪、滤镜等操作
• 配置灵活：支持自定义Nginx配置、PHP.ini参数及环境变量
• 框架兼容：兼容主流PHP应用框架（如Laravel、Symfony、WordPress等）

使用场景与适用范围

• 需要连接PostgreSQL数据库的Web应用（企业管理系统、数据报表平台）
• 涉及敏感数据处理、需实现数据加密的应用（用户认证系统、支付平台）
• 需要图像处理功能的应用（内容管理系统、电商平台商品图片处理）
• 开发与生产环境的一致性部署需求

使用方法与配置说明

基本使用（docker run）

bash
docker run -d -p 80:80 -v /path/to/your/app:/app docker.xuanyuan.run/webdevops/php-nginx:pgsql-sodium-imagick

参数说明：

• -p 80:80：将容器80端口映射到主机80端口
• -v /path/to/your/app:/app：挂载本地应用代码到容器内默认应用根目录/app

docker-compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  web:
    image: docker.xuanyuan.run/webdevops/php-nginx:pgsql-sodium-imagick
    ports:
      - "80:80"
    volumes:
      - ./app:/app  # 应用代码目录
      - ./nginx.conf:/opt/docker/etc/nginx/conf.d/default.conf  # 自定义Nginx配置
      - ./php.ini:/opt/docker/etc/php/php.ini  # 自定义PHP配置
    environment:
      - PHP_MEMORY_LIMIT=512M  # PHP内存限制
      - NGINX_CLIENT_MAX_BODY_SIZE=10M  # Nginx上传文件大小限制

启动服务：

bash
docker-compose up -d

扩展验证

进入容器验证扩展是否加载：

bash
docker exec -it [容器ID] php -m | grep -E "pgsql|sodium|imagick"

若输出包含上述扩展名称，说明扩展已成功加载。

自定义配置

• Nginx配置：挂载配置文件到/opt/docker/etc/nginx/conf.d/目录
• PHP配置：挂载php.ini到/opt/docker/etc/php/php.ini或添加配置片段到/opt/docker/etc/php/conf.d/目录
• 环境变量：通过-e参数或environment配置项设置PHP/Nginx参数（如PHP_ERROR_REPORTING、NGINX_WORKER_PROCESSES等）

注意事项

• 应用目录需设置适当权限，避免容器内权限问题
• 根据应用需求调整PHP内存限制、Nginx连接数等性能参数
• 生产环境建议配合持久化存储、数据库容器及反向代理使用