OpenFaaS 中 PHP 函数需用 php -S 0.0.0.0:8080 router.php 启动，处理 POST 请求、读取 php://input、返回 application/json 响应；Dockerfile 用 php:8.2-cli-slim 镜像，CMD 为数组格式，router.php 需禁用错误显示并严格输出 JSON。
OpenFaaS 函数在 PHP 中怎么跑起来
PHP 本身不是 OpenFaaS 官方首选语言（Go/Python/Node.js 更常见），但只要容器能启动 HTTP 服务、响应 POST 请求并输出 JSON，PHP 就能用。关键不是“能不能”，而是“怎么让 faas-cli build/deploy 不报错，且函数能被网关正确路由和调用”。
核心做法：用轻量 Web 服务器（如 php -S）包装函数逻辑，监听 0.0.0.0:8080，处理 POST / 请求，读取 php://input，返回标准 JSON 响应。OpenFaaS 网关会把请求体原样转发给你的 PHP 进程。
常见错误现象：502 Bad Gateway（PHP 服务没起来）、404 Not Found（路由不对或路径写死）、empty response（没 echo、没设 Content-Type 或输出了额外空格）。
- 必须用
php -S 0.0.0.0:8080 router.php启动，不能只写index.php—— OpenFaaS 要求统一入口点 -
router.php必须解析$_SERVER['REQUEST_METHOD'] === 'POST'，忽略 GET - 响应头必须包含
Content-Type: application/json，否则网关可能丢弃响应 - 所有输出必须是纯 JSON 字符串，不要
var_dump、print_r或调试 echo
如何写一个兼容 OpenFaaS 的 PHP handler
handler 不是传统 Web 脚本，它不依赖 Apache/Nginx，也不走 CGI；它是 CLI 模式下直面 HTTP 请求的独立服务。重点在于输入解析、错误隔离和结构化输出。
立即学习“PHP免费学习笔记（深入）”；
典型结构如下：
<?php
// router.php
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
http_response_code(405);
header('Content-Type: application/json');
echo json_encode(['error' => 'Method not allowed']);
exit;
}
<p>$body = file_get_contents('php://input');
$data = json_decode($body, true);</p><p>// 防止空输入导致 notice
$input = is_array($data) ? $data : ['input' => (string)$body];</p><p>// 实际业务逻辑在这里
$result = [
'message' => 'Hello from PHP',
'input_length' => strlen($input['input'] ?? ''),
'timestamp' => time()
];</p><p>http_response_code(200);
header('Content-Type: application/json');
echo json_encode($result);
注意：file_get_contents('php://input') 是唯一可靠方式读取原始 body；$_POST 在 OpenFaaS 场景下为空（无表单编码）。
- 不要用
$_GET或$_COOKIE—— OpenFaaS 不传这些 - 不要依赖 session —— 无状态函数要求每次调用完全独立
- 如果需要环境变量（如数据库连接串），通过
environment字段在stack.yml中注入，用getenv('DB_HOST')读取
faas-cli 构建失败常见原因及修复
faas-cli build 报错通常不是 PHP 语法问题，而是 Docker 构建层的问题：基础镜像不兼容、PHP 扩展缺失、或工作目录权限不对。
推荐使用 php:8.2-cli-slim 基础镜像（体积小、不含 Apache），并在 Dockerfile 中显式安装必要扩展：
FROM php:8.2-cli-slim
RUN apt-get update && apt-get install -y \
libzip-dev \
unzip \
&& rm -rf /var/lib/apt/lists/*
<p>RUN docker-php-ext-install zip</p><p>WORKDIR /home/app
COPY . .
EXPOSE 8080
CMD ["php", "-S", "0.0.0.0:8080", "router.php"]
容易踩的坑：
-
CMD必须是数组格式，不能写成字符串（如"php -S 0.0.0.0:8080 router.php"）—— 否则信号无法透传，faas-cli invoke可能超时 - 本地构建前确保
stack.yml中的lang字段设为dockerfile，不是php（后者会触发官方模板，不适用自定义 Dockerfile） - 如果用 Windows 编辑器保存
router.php，换行符可能是 CRLF，导致容器内 PHP 解析失败 —— 用dos2unix router.php修复
本地调试时 curl 怎么模拟 OpenFaaS 请求
别直接浏览器访问，也别用 faas-cli invoke 盲试。先绕过网关，直连容器端口验证 handler 是否正常：
启动容器后：
docker run -p 8080:8080 your-php-function
然后用 curl 测试：
curl -X POST http://localhost:8080/ \
-H "Content-Type: application/json" \
-d '{"name": "Alice", "age": 30}'
观察响应是否为合法 JSON、HTTP 状态码是否为 200、有没有意外空白或 warning 输出。这一步能快速区分问题是出在 PHP 逻辑，还是 OpenFaaS 网关配置。
真正部署后，faas-cli invoke 发出的请求内容与上面 curl 完全一致，只是 Host 和路径由网关代理。所以本地 curl 通了，90% 就算成功了一半。
最常被忽略的是：PHP 错误报告默认开启，未捕获异常会直接输出 HTML 错误页，而 OpenFaaS 网关只接受 JSON —— 必须在 router.php 开头加 error_reporting(0); ini_set('display_errors', 'Off');。
