PHP8.1 对接 DeepSeek 怎么封装 AI 接口请求函数-php教程-PHP中文网

php 8.1 对接 deepseek 推荐轻量 curl 封装：统一认证、结构化参数、强制 ssl 验证、错误分层处理；基础用单函数，进阶用可复用客户端类，生产环境需关注密钥安全、限流与响应字段提取。

php8.1 对接 deepseek 怎么封装 ai 接口请求函数

PHP 8.1 对接 DeepSeek，封装一个干净、可复用的 AI 接口请求函数，关键在于：统一认证、结构化参数、错误隔离、响应解耦。不需要重造轮子，但要避开常见坑（比如硬编码 URL、忽略 HTTPS 验证、不处理空响应）。

基础封装：单函数 + cURL + 环境变量取密钥

适合中小项目或快速验证，代码轻量、无依赖：

从 .env 或 getenv() 安全读取 DEEPSEEK_API_KEY，不写死密钥
固定使用 /v1/chat/completions 路径，符合 DeepSeek 当前主流接口规范
默认关闭流式（"stream": false），返回完整 JSON 响应体
强制启用 SSL 验证（CURLOPT_SSL_VERIFYPEER）、设置连接与总超时（推荐 3s + 10s）

示例函数：

function deepseekRequest(string $prompt, array $options = []): array
{
    $apiKey = getenv('DEEPSEEK_API_KEY') ?: throw new RuntimeException('DEEPSEEK_API_KEY not set');
    $url = 'https://api.deepseek.com/v1/chat/completions';

    $messages = [
        ['role' => 'user', 'content' => $prompt]
    ];

    $payload = array_merge([
        'model' => 'deepseek-chat',
        'messages' => $messages,
        'temperature' => 0.7,
        'stream' => false
    ], $options);

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($payload),
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . $apiKey
        ],
        CURLOPT_TIMEOUT => 10,
        CURLOPT_CONNECTTIMEOUT => 3,
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_SSL_VERIFYHOST => 2
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);

    if ($response === false || $httpCode !== 200) {
        throw new RuntimeException("DeepSeek API error (HTTP {$httpCode}): " . ($error ?: 'Empty response'));
    }

    $data = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new RuntimeException('Invalid JSON response from DeepSeek');
    }

    return $data;
}

调用方式简单直接：

$result = deepseekRequest('用 PHP 写一个计算斐波那契数列的函数');
echo $result['choices'][0]['message']['content'] ?? 'No content';

进阶封装：面向对象 + 可配置客户端类

适合中大型项目，支持多模型、多参数、扩展日志/重试/缓存等能力：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

构造时传入 API Key，内部复用 cURL 句柄（避免重复初始化开销）
方法分离：如 chat() 处理对话、complete() 处理补全（按实际接口区分）
支持动态覆盖模型、temperature、max_tokens 等常用字段
预留钩子：如 onError() 或异常类型分层（网络异常 vs API 错误）

最小可用类结构：

class DeepSeekClient
{
    private string $apiKey;
    private $curl;

    public function __construct(string $apiKey)
    {
        $this->apiKey = $apiKey;
        $this->curl = curl_init();
        curl_setopt_array($this->curl, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 10,
            CURLOPT_CONNECTTIMEOUT => 3,
            CURLOPT_SSL_VERIFYPEER => true,
            CURLOPT_SSL_VERIFYHOST => 2,
            CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_2_0,
        ]);
    }

    public function chat(string $prompt, array $options = []): array
    {
        $url = 'https://api.deepseek.com/v1/chat/completions';
        $payload = array_merge([
            'model' => 'deepseek-chat',
            'messages' => [['role' => 'user', 'content' => $prompt]],
            'temperature' => 0.7,
            'stream' => false
        ], $options);

        curl_setopt_array($this->curl, [
            CURLOPT_URL => $url,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode($payload),
            CURLOPT_HTTPHEADER => [
                'Content-Type: application/json',
                'Authorization: Bearer ' . $this->apiKey
            ]
        ]);

        $response = curl_exec($this->curl);
        $httpCode = curl_getinfo($this->curl, CURLINFO_HTTP_CODE);

        if ($response === false || $httpCode !== 200) {
            throw new RuntimeException("Chat request failed: HTTP {$httpCode}");
        }

        $data = json_decode($response, true);
        if (json_last_error() !== JSON_ERROR_NONE) {
            throw new RuntimeException('Invalid JSON in chat response');
        }

        return $data;
    }
}

使用示例：

$client = new DeepSeekClient(getenv('DEEPSEEK_API_KEY'));
$result = $client->chat('解释下 PHP 8.1 的枚举特性', [
    'temperature' => 0.3,
    'max_tokens' => 512
]);

生产环境必须注意的细节

不是“能跑就行”，而是“稳、安、可查”：

密钥安全：绝不提交到 Git；用 getenv() + .env（配合 vlucas/phpdotenv）或服务器环境变量
HTTPS 强制校验：确保 CURLOPT_SSL_VERIFYPEER 和 CURLOPT_SSL_VERIFYHOST 均为 true（开发调试除外）
错误分类处理：cURL 错误（网络层）、HTTP 状态码（4xx/5xx）、JSON 解析失败、API 返回 error 字段（如 $data['error']['message']）应分别捕获
限流友好：DeepSeek 免费版有 QPS 限制，建议在调用层加简单 sleep 或使用队列缓冲，避免 429
响应字段提取封装：别每次手动写 $res['choices'][0]['message']['content']，可加一个 extractText($res) 工具方法