custombuilder/php-base-openresty

PHP7.0-Openresty Docker镜像文档

镜像概述

本镜像集成PHP7.0运行环境与Openresty服务器，提供一站式Web应用部署解决方案。Openresty基于Nginx内核，集成LuaJIT，支持通过Lua脚本扩展Web服务器功能；PHP7.0则带来显著的性能提升与新特性，二者结合可满足高性能动态Web应用的运行需求。

核心功能与特性

1. 环境集成

• 内置PHP7.0运行环境，支持标准PHP语法及扩展
• 集成Openresty（基于Nginx），包含LuaJIT即时编译引擎
• 预配置FastCGI模块，实现Nginx与PHP-FPM的高效通信

2. 性能优化

• 基于Nginx的事件驱动架构，支持高并发请求处理
• Lua脚本通过LuaJIT编译执行，提升动态请求处理效率
• PHP7.0相比PHP5.x性能提升约2倍，降低资源占用

3. 扩展能力

• 支持自定义Lua脚本，实现请求过滤、数据处理、API路由等逻辑
• 可配置PHP扩展，满足不同应用依赖需求
• 兼容标准Nginx配置，支持反向代理、负载均衡等功能

使用场景

1. 开发环境

• 本地快速搭建PHP7.0+Openresty开发环境，无需手动配置依赖
• 支持代码热加载，便于实时调试PHP应用与Lua脚本

2. 生产环境部署

• 部署依赖Lua扩展的PHP Web应用（如API网关、动态内容处理服务）
• 构建高性能Web服务，处理高并发动态请求

3. 特殊业务场景

• 需要Lua脚本处理复杂请求逻辑的应用（如权限验证、数据转换）
• 结合Nginx反向代理与PHP动态内容的混合架构服务

使用方法

基本运行

通过以下命令启动容器，默认配置下可直接运行PHP应用：

bash
docker run -d -p 80:80 --name php7-openresty [镜像名称]

挂载应用代码

将本地PHP应用代码挂载至容器内Web根目录（默认/var/www/html）：

bash
docker run -d -p 80:80 \
  -v /本地应用路径:/var/www/html \
  --name php7-openresty [镜像名称]

自定义配置

挂载Nginx配置

替换默认Nginx配置（路径/usr/local/openresty/nginx/conf/nginx.conf）：

bash
docker run -d -p 80:80 \
  -v /本地/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  -v /本地应用路径:/var/www/html \
  --name php7-openresty [镜像名称]

挂载PHP配置

自定义PHP.ini配置（路径/usr/local/etc/php/php.ini）：

bash
docker run -d -p 80:80 \
  -v /本地/php.ini:/usr/local/etc/php/php.ini \
  -v /本地应用路径:/var/www/html \
  --name php7-openresty [镜像名称]

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  php7-openresty:
    image: [镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html          # 挂载应用代码
      - ./nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf  # 自定义Nginx配置
      - ./php.ini:/usr/local/etc/php/php.ini  # 自定义PHP配置
    restart: always

启动服务：

bash
docker-compose up -d

配置说明

目录结构

• Web根目录：/var/www/html（默认存放PHP应用代码）
• Nginx配置目录：/usr/local/openresty/nginx/conf（主配置文件nginx.conf）
• PHP配置目录：/usr/local/etc/php（主配置文件php.ini）
• Lua脚本目录：默认无固定路径，可在Nginx配置中通过lua_package_path指定

环境变量

自定义Nginx配置示例

在nginx.conf中添加Lua处理逻辑：

nginx
server {
    listen 80;
    server_name localhost;
    root /var/www/html;
    
    location / {
        index index.php index.html;
    }
    
    # 使用Lua处理/api请求
    location /api {
        default_type 'application/json';
        content_by_lua_block {
            ngx.say('{"status":"ok","message":"handled by Lua"}')
        }
    }
    
    # PHP处理
    location ~ \.php$ {
        fastcgi_pass $PHP_FPM_LISTEN;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}