php 8.6提供只读graphql接口时,可以先用webonyx/graphql-php明确query字段和参数,再启用查询深度及复杂度规则。下面接口只读取示例数组,不提供mutation;这能演示请求解析、变量和错误返回,但并不替代真实数据的身份验证与对象权限。

官方文档:Hello World
安装并定义公开字段
安装webonyx/graphql-php 15系列并启用mbstring。将下面文件保存为public/graphql.php,项目根目录保留vendor;Web根目录只指向public。
composer require webonyx/graphql-php:"^15.39"
<?php
require dirname(__DIR__).'/vendor/autoload.php';
use GraphQL\GraphQL;
use GraphQL\Type\Definition\ObjectType;
use GraphQL\Type\Definition\Type;
use GraphQL\Type\Schema;
use GraphQL\Validator\DocumentValidator;
use GraphQL\Validator\Rules\QueryDepth;
use GraphQL\Validator\Rules\QueryComplexity;
header('Content-Type: application/json; charset=utf-8');
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
http_response_code(405); header('Allow: POST'); exit;
}
$article = new ObjectType(['name'=>'Article', 'fields'=>[
'id'=>Type::nonNull(Type::id()), 'title'=>Type::nonNull(Type::string())
]]);
$rows = ['1'=>['id'=>'1','title'=>'PHP application notes']];
$query = new ObjectType(['name'=>'Query', 'fields'=>[
'article'=>['type'=>$article, 'args'=>['id'=>Type::nonNull(Type::id())],
'resolve'=>static fn($root, array $args)=>$rows[$args['id']] ?? null]
]]);
DocumentValidator::addRule(new QueryDepth(5));
DocumentValidator::addRule(new QueryComplexity(100));
try {
$raw = file_get_contents('php://input', false, null, 0, 1048577);
if ($raw === false || strlen($raw)>1048576) throw new InvalidArgumentException();
$input = json_decode($raw, false, 64, JSON_THROW_ON_ERROR);
if (!$input instanceof stdClass || !is_string($input->query ?? null)) {
throw new InvalidArgumentException();
}
$variables = $input->variables ?? null;
if ($variables !== null && !$variables instanceof stdClass) throw new InvalidArgumentException();
$operation = $input->operationName ?? null;
if ($operation !== null && !is_string($operation)) throw new InvalidArgumentException();
$result = GraphQL::executeQuery(new Schema(['query'=>$query]), $input->query,
null, null, $variables === null ? null : get_object_vars($variables), $operation);
echo json_encode($result->toArray(), JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
} catch (JsonException | InvalidArgumentException $e) {
http_response_code(400); echo '{"errors":[{"message":"Invalid request body"}]}';
} catch (Throwable $e) {
error_log($e::class); http_response_code(500);
echo '{"errors":[{"message":"Internal error"}]}';
}
官方文档:Query Complexity Analysis
发送带变量的查询
本地开发可从项目根目录执行php -S 127.0.0.1:8080 -t public,再发送请求。该开发服务器不用于生产部署。
curl -sS http://127.0.0.1:8080/graphql.php -H "Content-Type: application/json" --data '{"query":"query Read($id:ID!){article(id:$id){id title}}","variables":{"id":"1"}}'区分数据错误与资源限制
id为1时应能读取两项公开字段;不存在的id返回article:null。请求未知字段应得到GraphQL验证错误。QueryDepth和QueryComplexity默认不等同于请求大小、限流或数据库超时,仍要在HTTP入口和数据层分别配置;列表字段还应限制limit并按实际子项计算复杂度。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
接入业务数据时保留对象权限
只定义Query能阻止这个Schema中的Mutation入口,却不能保证查询结果没有敏感数据。把示例数组换成数据库前,需要对每个对象检查当前用户权限,使用绑定参数,并禁止把数据库异常或调试堆栈直接返回客户端。
立即学习“PHP免费学习笔记(深入)”;


















