QwenPHP调用函数全解析

本文深入解析了PHP如何间接对接Qwen大模型的函数调用（Function Calling）能力——由于Qwen本身不提供原生PHP SDK或直接调用接口，开发者必须通过DashScope、Fireworks等支持OpenAI兼容API的服务作为桥梁，正确配置tools和tool_choice参数、选用明确支持function calling的Qwen模型版本（如qwen2.5系列），并安全解析响应中可能为空或格式异常的tool_calls字段；文章直击常见踩坑点，从模型选型、请求头设置、JSON序列化细节到响应提取逻辑，给出可落地的PHP代码范例与关键避坑指南，帮你绕过文档模糊陷阱，真正打通Qwen智能体能力。

PHP 无法直接调用 Qwen 的函数调用（Function Calling）能力，因为 Qwen 的 function calling 是模型侧的推理机制，不是 HTTP 接口或 SDK 提供的可编程接口；你实际能对接的，是「带 function calling 能力的 API 服务」——比如 DashScope、OpenRouter 或自部署的 vLLM + OpenAI 兼容层，它们把 Qwen 模型封装成支持 tools 参数的 OpenAI-style 接口。

PHP 调用 Qwen function calling 必须走 OpenAI 兼容 API

Qwen 官方不提供原生 PHP SDK，也不开放底层 function calling 的 token-level 控制。所有“让 Qwen 执行函数”的行为，都依赖上游服务在请求中解析 tools、tool_choice，并在响应中返回 tool_calls 字段。PHP 做的只是标准 HTTP 请求和 JSON 解析。

• 必须使用支持 OpenAI v1/chat/completions 格式的后端（如 DashScope 的 /v1/services/aigc/text-generation/generation 启用 enable_function_calling）
• 请求体必须包含 tools 数组（每个元素含 type、function，其中 function.name 和 function.parameters 需符合 JSON Schema）
• 不能只传 functions（旧版 OpenAI 参数），Qwen 系列模型后端普遍只认 tools
• 响应里若出现 finish_reason: "tool_calls"，说明模型触发了函数调用，此时要提取 message.tool_calls 并执行对应逻辑

常见错误：PHP 发起请求后收不到 tool_calls

不是 PHP 写错了，而是配置或模型选择出了问题。最常踩的坑有三个：

• 用了 Qwen2-7B-Instruct 这类基础对话模型——它根本不支持 function calling，必须换用明确标注「Function Calling」的版本，例如 qwen2.5-72b-instruct（DashScope）或 qwen2.5-32b-instruct（Fireworks）
• tool_choice 设成了 "none" 或没传，导致服务跳过工具选择逻辑；应设为 "auto" 或指定 {"type": "function", "function": {"name": "xxx"}}
• PHP cURL 未设置 Content-Type: application/json，或 json_encode() 后没检查是否输出了 null（比如 parameters 里用了 PHP 引用或不可序列化对象）
• 某些平台（如早期 DashScope）要求额外 header：X-DashScope-OssResourceResolve: true，否则 tools 被静默忽略

PHP 示例：发送带 tools 的请求并安全提取 tool_calls

以下代码片段聚焦关键路径，省略异常重试和日志，仅展示结构正确性：

$payload = [
  'model' => 'qwen2.5-32b-instruct',
  'messages' => [['role' => 'user', 'content' => '查上海今天天气']],
  'tools' => [[
    'type' => 'function',
    'function' => [
      'name' => 'get_weather',
      'description' => '获取指定城市的实时天气',
      'parameters' => [
        'type' => 'object',
        'properties' => ['city' => ['type' => 'string']],
        'required' => ['city']
      ]
    ]
  ]],
  'tool_choice' => 'auto'
];

$json = json_encode($payload, JSON_UNESCAPED_UNICODE);
$response = file_get_contents('https://api.fireworks.ai/inference/v1/chat/completions', [
  'http' => [
    'method' => 'POST',
    'header' => "Content-Type: application/json\r\nAuthorization: Bearer {$api_key}",
    'content' => $json
  ]
]);

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

// 安全提取 tool_calls（注意：可能不存在，也可能为 null）
$toolCalls = $data['choices'][0]['message']['tool_calls'] ?? null;
if (is_array($toolCalls) && !empty($toolCalls)) {
  foreach ($toolCalls as $call) {
    if ($call['function']['name'] === 'get_weather') {
      $args = json_decode($call['function']['arguments'], true);
      // 执行真实天气查询逻辑
      $weather = get_weather($args['city']);
    }
  }
}

重点：不要假设 tool_calls 一定存在；$call['function']['arguments'] 是字符串，必须 json_decode；Qwen 输出的 JSON 可能带多余空格或换行，json_decode 第二个参数设为 true 更稳妥。

真正难的不是 PHP 怎么发请求，而是确认你用的 endpoint 是否真把 Qwen 的 function calling 能力打开了——很多文档写得模糊，得自己抓包看响应字段，或者直接 curl 测试原始 JSON 返回。

以上就是《QwenPHP调用函数全解析》的详细内容，更多关于的资料请关注golang学习网公众号！