php 8.6可以通过https向wikidata query service提交固定sparql查询,并按sparql json结果中的bindings读取变量值。查询应带有限数量、明确user-agent和客户端超时;公共端点的限制与数据变化不能由php客户端消除。

官方文档:Our first query
使用受控查询,不接收任意查询拼接
下面查询最多返回10个三元组,仅演示结果结构;不依赖某一时刻固定顺序。运行前将WIKIDATA_USER_AGENT设置为自己的应用名称与有效联系说明。应用如需用户筛选条件,应映射为受限参数或安全构造的RDF项,而不是直接拼接任意SPARQL。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

官方文档:ORDER and LIMIT
限制响应体并解析绑定值
<?php
$agent = getenv('WIKIDATA_USER_AGENT');
if (!$agent) { throw new RuntimeException('Set an application User-Agent'); }
$query = 'SELECT ?subject ?predicate ?object WHERE { ?subject ?predicate ?object } LIMIT 10';
$url = 'https://query.wikidata.org/sparql?' . http_build_query(['query' => $query]);
$body = '';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_USERAGENT => $agent,
CURLOPT_HTTPHEADER => ['Accept: application/sparql-results+json'],
CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 20,
CURLOPT_WRITEFUNCTION => function ($ch, string $chunk) use (&$body): int {
if (strlen($body) + strlen($chunk) > 2097152) { return 0; }
$body .= $chunk; return strlen($chunk);
},
]);
if (curl_exec($ch) === false) { throw new RuntimeException('SPARQL transport failed'); }
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) { throw new RuntimeException('SPARQL HTTP ' . $status); }
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!is_array($data['results']['bindings'] ?? null)) { throw new RuntimeException('Unexpected result'); }
foreach ($data['results']['bindings'] as $row) {
echo json_encode($row, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), "\n";
}保留值类型,不把绑定值全当字符串含义
绑定对象除了value,还可能包含type、datatype或xml:lang;URI、带类型的字面量和带语言文本应分别处理。LIMIT限制返回行数,不能保证复杂查询计算成本很低。遇到429或超时应停止当前请求并按服务规则退避,缓存可复用结果,不能无限并发重试。将返回值显示到网页时,还需按HTML上下文转义。


















