PHP接入GoogleAI平台教程

本文详解了PHP开发者如何绕过官方不支持的限制，通过REST API安全、可靠地调用Google Vertex AI（原AI Platform）的预测服务，重点揭示了OAuth2 access token的手动JWT签名获取方法（避免依赖不可靠的环境变量）、predict接口的URL构造与请求头/请求体规范、以及403/404/400等高频错误背后真实且隐蔽的权限、资源配置和编码细节问题——真正阻碍成功的从来不是PHP代码，而是Google Cloud IAM角色分配、JWT签名的base64url严格处理，以及location与endpoint_id在URL中毫厘不差的匹配。

PHP 本身不直接支持 Google AI Platform（现为 Vertex AI），官方 SDK 仅提供 Python、Java、Go、Node.js 客户端，google/apiclient 也不包含 Vertex AI 的专用服务类。想用 PHP 调用，必须走 REST API —— 这是唯一可行路径，别浪费时间找“PHP SDK”。

怎么调用 Vertex AI 的 predict 接口（以 TextGenerationModel 为例）

Vertex AI 的模型预测统一走 https://us-central1-aiplatform.googleapis.com/v1/projects/{project_id}/locations/{location}/endpoints/{endpoint_id}:predict（注意末尾的 :predict 冒号）。关键不是写对 URL，而是构造合法的 Authorization 头和请求体：

• Authorization: Bearer {access_token} —— 必须用短期有效的 OAuth2 access token，不能用 service account key file 直接签名请求体
• 请求体是 JSON，instances 字段必须是数组，即使只发一条；每个 instance 是对象，字段名取决于模型，如 text 或 prompt
• 必须显式设置 Content-Type: application/json，否则返回 400
• PHP 中推荐用 curl_setopt_array() 统一配置，避免漏掉 CURLOPT_RETURNTRANSFER 导致返回 null

如何安全获取 access_token（不用硬编码私钥）

把 service account key JSON 文件内容直接读取并调用 Google OAuth2 令牌端点换 token，是最轻量、最可控的方式。别用 google/auth 的 ApplicationDefaultCredentials —— 它在 PHP CLI 环境下会尝试找 GOOGLE_APPLICATION_CREDENTIALS 环境变量，但 Web 环境（如 Apache/Nginx）根本不可靠，且无法指定 scope。

• scope 固定为 https://www.googleapis.com/auth/cloud-platform，少一个字符都会报 invalid_scope
• 用 file_get_contents("sa-key.json") 读取后 json_decode()，提取 client_email 和 private_key
• JWT 签名必须用 openssl_sign() + SHA256，且 header 要含 "alg": "RS256" 和 "typ": "JWT"
• token endpoint 是 https://oauth2.googleapis.com/token，POST 数据中 grant_type 必须是 urn:ietf:params:oauth:grant-type:jwt-bearer

常见 403/404 错误对应的真实原因

这类错误几乎从不因为代码写错，而是权限或资源配置问题：

• 403 PERMISSION_DENIED：service account 没有 roles/aiplatform.user 角色，或者项目/位置/endpoint ID 写错（注意 endpoint ID 是纯数字字符串，不是完整 resource name）
• 404 NOT_FOUND：URL 中 locations/{location} 不匹配模型部署位置（如模型在 us-east1 却写了 us-central1），或 endpoint ID 根本不存在（Vertex AI 控制台里看 “Endpoint ID”，不是模型名称）
• 400 Invalid JSON payload：instances 不是数组、字段名拼错（如用了 input_text 而非 text）、没设 Content-Type
• 429 Rate Limit Exceeded：免费 tier 默认 QPS 极低（常为 1），别用 sleep(0.1) 模拟重试，应检查配额页面是否启用了对应 region 的 Vertex AI API

真正卡住人的永远不是 PHP 语法，而是 Google Cloud 的权限链（IAM → Service Account → Role → Endpoint Resource）、JWT 签名细节（比如 base64url 编码必须去掉 +// 并补 =）、以及 endpoint URL 中 location 和 ID 的严格匹配 —— 这三处出错，日志里几乎不提示具体哪错了。

本篇关于《PHP接入GoogleAI平台教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！