OpenWhisk PHP 动作开发指南

前言

OpenWhisk 是一个强大的无服务器计算平台，支持多种编程语言开发函数即服务（FaaS）。本文将详细介绍如何在 OpenWhisk 中使用 PHP 开发动作（Action），包括基础用法、打包技巧以及依赖管理等内容。

PHP 动作基础

运行时版本选择

OpenWhisk 提供多个 PHP 运行时版本支持，创建动作时可通过 --kind 参数指定：

• PHP 8.0：php:8.0
• PHP 7.4：php:7.4
• PHP 7.3：php:7.3

建议根据项目需求选择合适的 PHP 版本，通常推荐使用最新的稳定版本以获得更好的性能和安全性。

基本动作结构

PHP 动作的核心是一个顶级函数，默认入口函数名为 main。该函数接收一个关联数组参数，并返回一个关联数组。

<?php
function main(array $args) : array
{
    $name = $args["name"] ?? "stranger";
    $greeting = "Hello $name!";
    echo $greeting;  // 输出到日志
    return ["greeting" => $greeting];
}

数据类型支持

PHP 动作不仅支持返回 JSON 对象，还可以返回数组：

<?php
function main(array $args) : array
{
    return ["a", "b", "c"];
}

动作创建与调用

创建动作

使用 CLI 工具创建 PHP 动作：

wsk action create helloPHP hello.php

CLI 会根据文件扩展名自动识别 PHP 类型，默认使用 PHP 7.4 运行时。

调用动作

调用方式与其他语言动作一致：

wsk action invoke --result helloPHP --param name World

高级用法

多文件打包

当动作需要多个 PHP 文件时，可以打包为 zip 文件：

1. 确保入口文件名为 index.php
2. 打包相关文件：

zip -r helloPHP.zip index.php helper.php

3. 创建动作：

wsk action create helloPHP --kind php:7.4 helloPHP.zip

依赖管理

对于需要 Composer 依赖的项目：

1. 安装依赖：

composer require package/name

2. 打包 vendor 目录：

zip -r helloPHP.zip index.php vendor

3. 创建动作：

wsk action create helloPHP --kind php:7.4 helloPHP.zip

运行时环境会自动加载 Composer 的 autoloader，无需额外配置。

内置扩展与依赖

预装 PHP 扩展

除标准扩展外，OpenWhisk PHP 运行时还预装了以下常用扩展：

• 数学计算：bcmath
• 网络请求：curl
• 图像处理：gd
• 国际化：intl
• 多字节字符串：mbstring
• 数据库驱动：mysqli, pdo_mysql, pdo_pgsql, pdo_sqlite
• MongoDB 支持：mongodb
• Web 服务：soap
• 压缩处理：zip

默认 Composer 包

如果没有提供自己的 vendor 目录，运行时会自动包含以下常用包：

• HTTP 客户端：guzzlehttp/guzzle
• UUID 生成：ramsey/uuid

这些包的版本会随运行时更新，建议查看对应版本的变更日志获取详细信息。

最佳实践

1. 错误处理：在动作中加入适当的异常捕获和错误处理逻辑
2. 日志记录：使用 echo 或 error_log 输出调试信息
3. 资源清理：对于需要清理的资源（如数据库连接），使用 register_shutdown_function
4. 性能优化：对于复杂计算，考虑使用 OPcache 优化
5. 版本控制：明确指定 PHP 运行时版本，避免意外行为

总结

OpenWhisk 为 PHP 开发者提供了完整的无服务器解决方案。通过本文介绍的基础动作开发、多文件打包和依赖管理技巧，开发者可以高效构建 PHP 无服务器函数。合理利用预装扩展和默认包，可以显著减少部署包体积，提高执行效率。