apache/openserverless-runtime-php

Apache OpenWhisk PHP Runtime 镜像文档

1. 镜像概述和主要用途

Apache OpenWhisk PHP Runtime 镜像由 Apache OpenServerless（孵化中）项目提供，是专为 Apache OpenWhisk 无服务器平台设计的 PHP 运行时环境。该镜像用于在 OpenWhisk 平台上执行 PHP 函数（Action），提供 PHP 代码的运行时支持、资源隔离及与 OpenWhisk 系统的集成能力，是构建基于 PHP 的无服务器应用的核心组件。

2. 核心功能和特性

2.1 核心功能

• 提供 PHP 代码执行环境，支持在 OpenWhisk 平台上部署和运行 PHP 函数
• 与 OpenWhisk 事件驱动模型集成，响应 HTTP 请求、定时触发器等事件
• 实现 OpenWhisk Action 生命周期管理（初始化、执行、清理）
• 支持函数输入/输出数据的标准化处理（JSON 格式为主）

2.2 关键特性

• 轻量级设计：优化镜像体积，减少启动时间，提升函数冷启动效率
• PHP 版本支持：兼容主流 PHP 稳定版本（具体版本需参考镜像标签，如 php7.4、php8.1 等）
• 标准扩展支持：内置常用 PHP 扩展（如 json、curl、mbstring 等），满足基础开发需求
• 资源隔离：基于容器化技术，确保函数运行时资源隔离与安全性
• 日志集成：支持将函数执行日志输出至 OpenWhisk 系统日志收集管道

3. 使用场景和适用范围

3.1 典型使用场景

• API 后端服务：构建基于 PHP 的轻量级 API 接口，响应 HTTP 请求
• 数据处理任务：处理文本、格式转换、数据库操作等 PHP 擅长的业务逻辑
• 定时任务：通过 OpenWhisk 定时触发器执行周期性 PHP 脚本（如数据同步、报表生成）
• 事件响应：响应消息队列、文件上传等事件触发的 PHP 业务逻辑

3.2 适用范围

• 用户群体：PHP 开发者、无服务器应用开发团队、DevOps 工程师
• 平台环境：Apache OpenWhisk 集群（自托管或云服务）
• 开发阶段：开发、测试、生产环境（需根据镜像标签选择稳定版本）

4. 使用方法和配置说明

4.1 镜像获取

通过 Docker Hub 或 Apache OpenServerless 官方仓库拉取镜像（具体地址需参考项目发布渠道）：

bash
docker pull apache/openwhisk-runtime-php:<tag>  # 例如: apache/openwhisk-runtime-php:7.4

4.2 在 OpenWhisk 中配置运行时

4.2.1 运行时注册（管理员操作）

OpenWhisk 管理员需将该镜像注册为平台支持的运行时，通过修改 OpenWhisk 控制器配置（如 config.yaml）添加 PHP 运行时：

yaml
runtimes:
  php:
    image: apache/openwhisk-runtime-php:7.4
    default: true
    kinds:
      - kind: php:7.4

4.2.2 函数部署（开发者操作）

开发者通过 OpenWhisk CLI (wsk) 部署 PHP 函数，示例如下：

1. 创建 PHP 函数文件（如 index.php）：

   php
   <?php
   function main(array $args) : array {
       $name = $args['name'] ?? 'World';
       return ['message' => "Hello, $name!"];
   }
   ?>
   

2. 部署为 OpenWhisk Action：

   bash
   wsk action create php-hello index.php --kind php:7.4
   

3. 触发函数执行：

   bash
   wsk action invoke php-hello -p name "OpenWhisk" --result
   

   输出示例：

   json
   { "message": "Hello, OpenWhisk!" }
   

4.3 环境变量

运行时会自动注入 OpenWhisk 系统环境变量，供 PHP 函数使用，主要包括：

4.4 配置参数

4.4.1 PHP 配置自定义

如需修改 PHP 运行时配置（如 php.ini 参数），可通过以下方式：

• 构建自定义镜像：基于官方镜像，通过 Dockerfile 添加或修改 php.ini：

  dockerfile
  FROM apache/openwhisk-runtime-php:7.4
  COPY custom-php.ini /usr/local/etc/php/conf.d/
  

• 运行时挂载：在 OpenWhisk 运行时配置中，通过挂载外部 php.ini 文件覆盖默认配置（需平台支持持久化存储挂载）。

4.4.2 资源限制配置

通过 OpenWhisk Action 部署参数指定函数资源限制，如内存、超时时间：

bash
wsk action create php-hello index.php --kind php:7.4 --memory 256 --timeout 3000

• --memory：内存限制（MB，默认 256）
• --timeout：超时时间（毫秒，默认 60000）

5. Docker 部署方案示例

5.1 本地测试（Docker Run）

直接通过 Docker 运行镜像，模拟 OpenWhisk 运行时环境（用于调试）：

bash
docker run -it --rm \
  -e "__OW_ACTION_NAME=test-action" \
  -e "__OW_NAMESPACE=default" \
  -v $(pwd)/index.php:/action/exec \
  apache/openwhisk-runtime-php:7.4

说明：本地测试需手动模拟 OpenWhisk 输入输出格式，实际生产环境需通过 OpenWhisk 平台调度。

5.2 OpenWhisk 集群部署（Docker Compose 示例）

在 OpenWhisk 集群中，可通过 Docker Compose 配置运行时服务（仅供参考，具体需结合 OpenWhisk 集群部署文档）：

yaml
version: '3'
services:
  php-runtime:
    image: apache/openwhisk-runtime-php:7.4
    restart: always
    networks:
      - openwhisk-network
    environment:
      - "PORT=8080"
      - "OW_RUNTIME_HTTP_PORT=8080"
networks:
  openwhisk-network:
    external: true

6. 注意事项

• 镜像标签对应 PHP 版本，生产环境建议使用固定版本标签（如 7.4），避免 latest 标签导致版本变更风险
• 函数代码需遵循 OpenWhisk Action 规范：入口函数为 main(array $args): array，输入输出为 JSON 可序列化数组
• 如需使用额外 PHP 扩展，需通过自定义镜像构建（官方镜像仅包含基础扩展）
• 函数执行超时时间受 OpenWhisk 平台限制，默认最大 5 分钟，需根据业务需求合理设置