给现有 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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。