PHP对接ChatGPT实战：从API调用到生产环境优化

10次阅读

共计 3364 个字符，预计需要花费 9 分钟才能阅读完成。

在实际对接 ChatGPT API 时，PHP 开发者常遇到以下典型问题：

认证管理复杂 ：API 密钥需要安全存储和轮换，手动处理 Authorization 头容易出错
长文本截断 ：默认的同步请求方式无法处理大篇幅响应，导致数据不完整
响应延迟高 ：国内直连 OpenAI 服务器平均延迟超过 2 秒，影响用户体验
错误恢复困难 ：遇到 rate limit 或临时故障时缺乏标准重试机制

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.openai.com/v1/chat/completions',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer'.$apiKey
    ],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([/* 请求体 */]),
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);

优点：
– 原生支持无需额外依赖
– 细粒度控制连接参数

缺点：
– 手动处理 HTTP 细节
– 缺乏连接池管理

$client = new \GuzzleHttp\Client([
    'base_uri' => 'https://api.openai.com',
    'timeout'  => 30.0
]);

$response = $client->post('/v1/chat/completions', [
    'headers' => ['Authorization' => 'Bearer'.$apiKey],
    'json' => [/* 请求体 */]
]);

优点：
– 符合 PSR- 7 标准
– 内置连接复用
– 支持异步请求

生产建议 ：中大型项目推荐 Guzzle，简单脚本可使用 cURL

/**
 * ChatGPT 服务封装
 * @implements ChatGPTInterface
 */
class ChatGPTService implements ChatGPTInterface
{
    private HttpClientInterface $client;
    private string $apiKey;

    public function __construct(HttpClientInterface $client, string $apiKey) 
    {
        $this->client = $client;
        $this->apiKey = $apiKey;
    }

    /**
     * 发送对话请求
     * @throws ChatGPTException
     */
    public function chat(array $messages): array 
    {
        try {
            $response = $this->client->request('POST', '/v1/chat/completions', ['headers' => $this->buildHeaders(),
                'json' => [
                    'model' => 'gpt-3.5-turbo',
                    'messages' => $messages,
                    'stream' => false
                ]
            ]);

            return $this->processResponse($response);
        } catch (RequestException $e) {throw new ChatGPTException('API 请求失败:'.$e->getMessage());
        }
    }
}

public function streamChat(array $messages): \Generator 
{
    $response = $this->client->request('POST', '/v1/chat/completions', ['headers' => $this->buildHeaders(),
        'json' => [
            'model' => 'gpt-3.5-turbo',
            'messages' => $messages,
            'stream' => true
        ],
        'stream' => true
    ]);

    foreach (explode("\n", $response->getBody()) as $chunk) {if (strpos($chunk, 'data:') === 0) {yield json_decode(substr($chunk, 6), true);
        }
    }
}

Session 方案 （适合 Web 应用）

$_SESSION['chat_context'] = array_slice(array_merge($_SESSION['chat_context'] ?? [], $newMessages),
    -10 // 保留最近 10 条
);

Token 计数方案 （精确控制成本）

$tokenCount = 0;
$filteredMessages = array_filter($messages, function($msg) use (&$tokenCount) {$tokenCount += mb_strlen($msg['content']) / 4;
    return $tokenCount < 3500; // 模型上限
});

$retryDelay = 1000; // 初始 1 秒
$maxRetries = 3;

for ($attempt = 0; $attempt < $maxRetries; $attempt++) {
    try {return $this->client->request(/* ... */);
    } catch (RequestException $e) {if ($attempt === $maxRetries - 1) throw $e;
        usleep($retryDelay * (2 ** $attempt)); // 指数退避
    }
}

$filteredText = preg_replace('/\b(?:\d{4}[-]?){4}\b/', 
    '[CARD]', 
    $userInput
);

记录 API 响应时间百分位
跟踪 token 使用量
监控错误率（429/5xx）

try {$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
} catch (\JsonException $e) {
    // 检查 BOM 头或非法字符
    $cleanJson = preg_replace('/[^\x20-\x7E\t\n\r]/', '', $response);
    $data = json_decode($cleanJson, true);
}

客户端实现令牌桶算法
优先保证重要请求（付费用户）
失败请求入队列异步重试

香港中转服务器部署
使用 Cloudflare Workers 代理
响应数据压缩（brotli）

public function testChatCompletion()
{
    $mock = new MockHandler([new Response(200, [], json_encode(['choices' => [['message' => ['content' => 'test']]]
        ]))
    ]);

    $service = new ChatGPTService(new Client(['handler' => $mock]), 'fake_key');
    $result = $service->chat([/* messages */]);

    $this->assertArrayHasKey('choices', $result);
}