php可以通过deepseek的anthropic兼容messages接口声明deepseek_web_search,让deepseek-flash在服务端决定是否搜索,然后从content中的text块读取回答和引用。下例要求php 8.1以上启用curl扩展,并在运行环境设置deepseek_api_key;使用非流式请求,关闭思考以便先验证普通联网搜索。模型内搜索与抓取不再另收按次费用,但模型token仍计费。

官方示例展示服务端工具名称;本文下方采用非流式普通搜索示例。
发送一次请求并读取文本内容块
<?php declare(strict_types=1);
$key = getenv('DEEPSEEK_API_KEY');
if ($key === false || $key === '') {
throw new RuntimeException('请设置DEEPSEEK_API_KEY');
}
$payload = [
'model' => 'deepseek-flash',
'max_tokens' => 1024,
'thinking' => ['type' => 'disabled'],
'tools' => [['type' => 'deepseek_web_search', 'name' => 'deepseek_web_search']],
'messages' => [['role' => 'user', 'content' => '请查询PHP官网,说明PHP8.6正式版当前发布状态并附来源']],
'stream' => false,
];
$ch = curl_init('https://api.deepseek.com/anthropic/v1/messages');
if ($ch === false) {
throw new RuntimeException('cURL初始化失败');
}
try {
$ok = curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'x-api-key: ' . $key],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 180,
]);
if (!$ok) {
throw new RuntimeException('cURL选项设置失败');
}
$raw = curl_exec($ch);
if ($raw === false) {
throw new RuntimeException('传输失败:' . curl_error($ch));
}
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status = 300) {
throw new RuntimeException('接口HTTP状态:' . $status);
}
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if (!is_array($data) || isset($data['error'])) {
throw new RuntimeException('接口返回业务错误或无效结构');
}
$texts = [];
foreach (($data['content'] ?? []) as $block) {
if (($block['type'] ?? '') !== 'text' || !is_string($block['text'] ?? null)) {
continue;
}
$texts[] = $block['text'];
foreach (($block['citations'] ?? []) as $citation) {
if (is_string($citation['url'] ?? null)) {
fwrite(STDERR, '来源:' . $citation['url'] . PHP_EOL);
}
}
}
if (!$texts) {
throw new RuntimeException('没有可读文本,请检查停止原因与工具结果');
}
echo implode('', $texts), PHP_EOL;
fwrite(STDERR, '结束原因:' . ($data['stop_reason'] ?? 'unknown') . PHP_EOL);
} finally {
curl_close($ch);
}
保存为search.php,配置环境变量后在命令行执行php search.php。回答写到标准输出,引用地址和停止原因写到标准错误;工具是否真的搜索要结合响应中的server_tool_use和工具结果块判断,不能因为声明了工具就认定每次都会联网。

工具调用和结果按tool_use_id关联,文本块不能替代全部响应结构。
HTTP成功仍要检查业务结束状态
非流式响应可能在HTTP 200下携带error,因此示例在解析JSON后再次检查。stop_reason为max_tokens时可能是答案被截断或检索后上下文不足,不能当作完整回答;refusal表示拒答。工具结果本身也可能为unavailable,应该展示可读失败状态,而不是把工具块当成正文。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
不要强行指定服务端工具
tool_choice不能指定deepseek_web_search或deepseek_read_url,否则会返回400;模型自行决定是否调用。若只需读取用户提供的网址,可以仅声明deepseek_read_url。网页展示回答时应转义文本,引用链接也应先校验协议;密钥只从服务端环境读取,不传给浏览器。多轮功能需要按官方规则回传完整内容块和signature,不能只保留本例打印出的文字继续对话。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










