给现有 PHP 系统加 AI 能力,最常见的方式是调用模型 API。它本质上就是一次 HTTP 请求,和调支付接口没有本质区别。难点不在协议,而在超时、重试、成本与结果可靠性。
最小调用示例
<?php
function chat(string $prompt): string
{
$payload = [
'model' => 'your-model-name',
'messages' => [
['role' => 'system', 'content' => '你是一名严谨的 PHP 技术助手,回答简洁。'],
['role' => 'user', 'content' => $prompt],
],
'temperature' => 0.3,
];
$ch = curl_init('https://api.example.com/v1/chat/completions');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . getenv('AI_API_KEY'),
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
CURLOPT_TIMEOUT => 60,
CURLOPT_CONNECTTIMEOUT => 5,
]);
$resp = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$err = curl_error($ch);
curl_close($ch);
if ($resp === false) {
throw new RuntimeException('请求失败:' . $err);
}
if ($code >= 400) {
throw new RuntimeException('接口返回 ' . $code . ':' . $resp);
}
$data = json_decode($resp, true);
return $data['choices'][0]['message']['content'] ?? '';
}
四个工程化要点
- 密钥不进代码:放环境变量,且不要写进前端;
- 超时与重试:连接超时 5 秒、总超时 30-60 秒,失败重试最多两次并加退避;
- 异步化:长任务放队列,别让用户请求等 40 秒;
- 成本控制:记录每次调用的 token 数,按用户/功能维度做配额。
工具调用(Function Calling)
让模型”能查数据”,靠的是工具调用:你声明可用的函数与参数结构,模型返回”要调用哪个函数、参数是什么”,由你的 PHP 代码执行后把结果回传。
<?php
$tools = [[
'type' => 'function',
'function' => [
'name' => 'get_order_status',
'description' => '根据订单号查询订单当前状态',
'parameters' => [
'type' => 'object',
'properties' => [
'order_no' => ['type' => 'string', 'description' => '订单编号'],
],
'required' => ['order_no'],
],
],
]];
// 模型返回 tool_calls 后,由服务端执行真实查询
// 关键:参数必须再次校验,不能直接拼进 SQL
这里的核心安全原则:模型给的是”意图”,不是”授权”。它说要查订单,你仍要校验当前用户是否有权查这个订单。否则等于给了模型一个越权入口。
结果可靠性
模型输出是概率性的,不要让它直接生成可执行 SQL 或 HTML。正确做法是让它输出结构化 JSON,由你的代码解析、校验、再渲染。解析失败就重试或降级,绝不能把原始输出直接塞进页面。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。