tofuliang/docker-php-openresty

docker-php-openresty 镜像文档

镜像概述

docker-php-openresty是一个预集成PHP运行环境与OpenResty的Docker镜像。OpenResty基于Nginx核心并集成LuaJIT，该镜像旨在为PHP应用提供高性能、低延迟的Web服务运行环境，简化开发与生产环境的部署流程，同时支持Lua脚本扩展与Nginx高级功能。

核心功能与特性

• 环境集成：预配置PHP运行环境与OpenResty（Nginx+LuaJIT），开箱即用
• 性能优化：基于OpenResty的事件驱动架构，提升高并发场景下的请求处理能力
• 扩展支持：内置常用PHP扩展（如mysqli、pdo_mysql、gd、curl等），支持按需添加额外扩展
• 配置灵活：允许通过环境变量或配置文件挂载自定义PHP.ini与Nginx配置
• 版本可控：支持指定PHP与OpenResty版本，确保环境一致性
• 轻量设计：基于Alpine或Debian slim基础镜像，优化镜像体积与启动速度

使用场景与适用范围

• 高性能PHP应用：适用于电商平台、内容管理系统（CMS）等需高并发处理的PHP Web应用
• 混合脚本服务：需同时运行PHP与Lua脚本的业务场景（如API网关、数据处理服务）
• 开发与生产一致性：通过容器化确保开发、测试、生产环境配置统一
• 微服务架构：作为微服务架构中的PHP应用节点，提供高效HTTP服务

使用方法与配置说明

基本使用

快速启动容器

通过docker run命令启动基础服务，将本地应用目录挂载至容器Web根目录：

bash
docker run -d -p 80:80 \
  --name php-openresty-demo \
  -v /path/to/your/php/app:/usr/local/openresty/nginx/html \
  docker-php-openresty

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

自定义配置

挂载配置文件

自定义Nginx配置

挂载本地Nginx配置文件覆盖容器默认配置：

bash
docker run -d -p 80:80 \
  -v /path/to/your/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  -v /path/to/your/php/app:/usr/local/openresty/nginx/html \
  docker-php-openresty

自定义PHP配置

挂载本地php.ini文件修改PHP配置：

bash
docker run -d -p 80:80 \
  -v /path/to/your/php.ini:/usr/local/etc/php/php.ini \
  -v /path/to/your/php/app:/usr/local/openresty/nginx/html \
  docker-php-openresty

环境变量配置

通过环境变量自定义服务参数，常用变量说明如下：

示例：指定版本与扩展

bash
docker run -d -p 80:80 \
  -e PHP_VERSION=8.2 \
  -e OPENRESTY_VERSION=1.23.4.1 \
  -e PHP_EXTENSIONS=redis,memcached \
  -v /path/to/your/php/app:/usr/local/openresty/nginx/html \
  docker-php-openresty

Docker Compose配置示例

创建docker-compose.yml文件管理服务配置：

yaml
version: '3.8'

services:
  php-openresty:
    image: docker-php-openresty
    container_name: php-openresty-service
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS，映射443端口
    volumes:
      - ./app:/usr/local/openresty/nginx/html  # 本地PHP应用目录
      - ./nginx/conf.d:/usr/local/openresty/nginx/conf/conf.d  # Nginx子配置
      - ./php/php.ini:/usr/local/etc/php/php.ini  # 自定义PHP配置
      - ./ssl:/usr/local/openresty/nginx/ssl  # SSL证书目录（如需HTTPS）
    environment:
      - PHP_VERSION=8.2
      - PHP_MEMORY_LIMIT=512M
      - NGINX_WORKER_PROCESSES=4
    restart: unless-stopped  # 容器退出时自动重启（非手动停止情况）

启动服务：

bash
docker-compose up -d

注意事项

• 权限管理：挂载本地目录时确保容器内用户（通常为nginx或www-data）对挂载目录有读写权限，可通过-u参数指定用户ID
• 版本指定：生产环境建议使用具体版本标签（如docker-php-openresty:8.2-1.23.4.1-alpine）而非latest，避免版本变更导致兼容性问题
• 配置备份：自定义配置文件建议通过版本控制管理，确保配置可追溯
• 性能调优：高并发场景下可调整Nginx的worker_connections（连接数）、keepalive_timeout（长连接超时）等参数优化性能