PHP在Google Cloud Functions上必须使用PSR-7规范：入口函数需接收ServerRequestInterface并返回ResponseInterface，否则触发500错误；部署须指定--runtime php82、--trigger-http、--allow-unauthenticated、--source=.和--entry-point=xxx；依赖须提前vendor化，不可由GCP自动安装。
PHP 能直接用在 Google Cloud Functions 上，但只支持 HTTP 触发器（不支持后台事件触发，比如 Cloud Storage 变更），且必须用 psr/http-server-request 和 psr/http-server-response 接口规范 —— 这不是可选项，是部署失败的最常见原因。
为什么 helloWorld($request) 会 500 错误？
旧式写法（如直接接收 $request 参数、无返回值、或返回字符串）在新版 GCP PHP 运行时（php81 / php82）会直接崩溃。GCP 不再自动包装你的函数，它要求你显式实现 PSR-7 兼容的请求/响应处理流程。
常见错误现象：
- 部署成功但访问返回
500 Internal Server Error，日志里只有Function execution failed: TypeError: Argument 1 passed to helloWorld() must be an instance of Psr\Http\Message\ServerRequestInterface - 函数返回空白页面，Cloud Logging 显示
ResponseInterface not returned
正确做法：
立即学习“PHP免费学习笔记（深入）”；
- 入口函数必须接收
Psr\Http\Message\ServerRequestInterface并返回Psr\Http\Message\ResponseInterface - 不能依赖全局
$_GET或$_POST，必须从$request对象中提取数据 - 必须用
withStatus()和withHeader()显式构造响应，不能直接echo或return "string"
示例修正后代码：
<?php
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Message\ResponseInterface;
function helloWorld(ServerRequestInterface $request, ResponseInterface $response): ResponseInterface
{
$name = $request->getQueryParams()['name'] ?? 'World';
$body = sprintf('Hello, %s!', htmlspecialchars($name));
return $response
->withStatus(200)
->withHeader('Content-Type', 'text/plain; charset=utf-8')
->withBody(\GuzzleHttp\Psr7\Utils::streamFor($body));
}
gcloud functions deploy 必须带的参数有哪些？
漏掉任意一个关键参数都会导致部署失败或函数不可调用。尤其注意：PHP 运行时不支持 php74 之后的旧版本，当前推荐用 php82（php81 已进入维护期）。
通过 SerpApi 查询 Google Flights，获取航班时刻表、价格及舱位等级信息。当用户询问航班 / 机票 / 航班价格、时刻表或对比信息时使用。
-
--runtime php82：必须明确指定，不能省略；php80及更早版本已弃用 -
--trigger-http：PHP 函数仅支持 HTTP 触发，此参数不可省略 -
--allow-unauthenticated：若不加，函数默认私有，调用会返回403；生产环境应改用 IAM 鉴权，但开发阶段必须加 -
--entry-point=helloWorld：必须与函数名完全一致，区分大小写；若函数在命名空间内，需写全路径，如App\Functions\helloWorld -
--source=.：源码目录必须包含index.php（或你指定的入口文件），且该文件需require到函数定义文件
典型部署命令：
gcloud functions deploy helloWorld \ --runtime php82 \ --trigger-http \ --allow-unauthenticated \ --source=. \ --entry-point=helloWorld \ --region=us-central1
本地调试和依赖管理怎么搞？
Cloud Functions 不执行 composer install，所有依赖必须提前 vendor 化并随代码一起上传 —— 这是新手最容易忽略的环节。
- 项目根目录必须有
composer.json，且声明了"require": {"php": "^8.2"}等最低约束 - 运行
composer install --no-dev --optimize-autoloader，生成vendor/目录；不加--no-dev会导致部署包过大甚至超限（250MB 压缩包限制） - 不能把
vendor/放进.gcloudignore；也不能依赖 GCP 自动安装 —— 它不会帮你跑composer - 若用到 Google 官方 SDK（如
google/cloud-storage），需确保其版本兼容 PSR-7 实现（推荐^3.0）
验证方式：压缩当前目录（含 vendor/），检查是否 ≤ 250MB；解压后运行 php -l index.php 确保语法无错。
HTTP 请求体大了怎么办？
Cloud Functions 默认限制请求体为 10MB（gzip 后），且无配置项可调高。如果你要上传文件或接收大 JSON，必须换思路。
- 不要让前端直传大 payload 到函数 URL —— 会直接 413
- 正确做法：前端先向
Cloud Storage申请一个签名上传 URL（通过另一个轻量函数返回），再用PUT直传到 bucket；函数后续通过google/cloud-storage读取对象 - 若坚持走 HTTP body，只能拆小（如分片上传 + 合并逻辑），但极不推荐 —— 函数执行时间上限 9分钟，且内存有限（最高 8GB，但 PHP 内存开销大）
- 注意：即使你设了
--memory=8GB，PHP 的memory_limit默认仍是 128M，需在php.ini中覆盖（见下条）
如需调整 PHP 运行时参数，可在项目根目录放 php.ini：
memory_limit = 512M max_execution_time = 540 upload_max_filesize = 8M
这个文件会被 GCP 自动加载，但仅影响当前函数进程 —— 不是全局服务器配置。
真正麻烦的是 PSR-7 流式处理：一旦你用了 GuzzleHttp\Psr7\Utils::streamFor()，就别想用 json_decode(file_get_contents('php://input')) —— 输入流只能读一次，且函数启动时已消耗。所有解析逻辑必须在 $request->getBody() 上做流操作或缓存，否则拿不到原始数据。
