GraphQL是一個用于API的查詢語言，它可以讓客戶端精確地查詢數(shù)據(jù)，避免浪費網(wǎng)絡(luò)帶寬和服務(wù)器資源。在本文中，我們將討論如何使用PHP創(chuàng)建GraphQL API。
GraphQL API的工作原理
GraphQL API是基于查詢語言的。客戶端發(fā)送查詢請求到服務(wù)器，服務(wù)器解析請求并返回相應(yīng)數(shù)據(jù)。請求和響應(yīng)都是以GraphQL語言格式發(fā)送和接收的。
GraphQL API還支持多級關(guān)聯(lián)查詢，客戶端可以查詢一些數(shù)據(jù)，然后在同一個查詢中請求相關(guān)數(shù)據(jù)。這大大減少了網(wǎng)絡(luò)帶寬和服務(wù)器開銷。
GraphQL API中有三個主要的概念：查詢、類型和解析器。查詢是客戶端發(fā)送的請求，GraphQL類型是API中使用的對象，解析器是將請求轉(zhuǎn)換為響應(yīng)的代碼。
創(chuàng)建GraphQL API
我們將使用PHP實現(xiàn)GraphQL API，并使用webonyx/graphql-php庫來構(gòu)建和解析查詢。
首先，我們需要創(chuàng)建一些GraphQL類型，這些類型描述了API中的對象。以下是一個示例User類型：
use GraphQLTypeDefinitionType;
use GraphQLTypeDefinitionObjectType;
$userType = new ObjectType([
'name' => 'User',
'fields' => [
'id' => Type::int(),
'name' => Type::string(),
'email' => Type::string()
]
]);
登錄后復(fù)制
上面的代碼創(chuàng)建了一個名為User的類型，包含三個字段：id、name和email。每個字段都有一個類型，Type::int()表示整數(shù)類型，Type::string()表示字符串類型。
接下來，我們需要創(chuàng)建一個解析器來處理查詢。以下是一個示例用戶查詢解析器：
$rootValue = [
'users' => [
['id' => 1, 'name' => 'Alice', 'email' => '[email protected]'],
['id' => 2, 'name' => 'Bob', 'email' => '[email protected]']
]
];
$resolver = function ($root, $args) {
global $rootValue;
if (isset($args['id'])) {
foreach ($rootValue['users'] as $user) {
if ($user['id'] == $args['id']) {
return $user;
}
}
} else {
return $rootValue['users'];
}
};
登錄后復(fù)制
上面的代碼創(chuàng)建了一個$rootValue數(shù)組，它包含了兩個用戶對象。$resolver函數(shù)會根據(jù)客戶端發(fā)送的請求來返回相應(yīng)的數(shù)據(jù)。如果請求帶有id參數(shù)，將返回具有該id的用戶信息，否則將返回所有用戶信息。
最后，我們需要將上述類型和解析器綁定到GraphQL API中。以下是綁定代碼：
use GraphQLGraphQL;
use GraphQLTypeSchema;
$schema = new Schema([
'query' => new ObjectType([
'name' => 'Query',
'fields' => [
'user' => [
'type' => $userType,
'args' => ['id' => Type::int()],
'resolve' => $resolver
],
'users' => [
'type' => Type::listOf($userType),
'resolve' => $resolver
]
]
])
]);
if (!empty($_POST['query'])) {
$result = GraphQL::executeQuery($schema, $_POST['query']);
echo json_encode($result->toArray());
}
登錄后復(fù)制
上面的代碼將用戶類型和解析器綁定到GraphQL API中，并創(chuàng)建了一個查詢對象。在查詢對象中，我們可以定義多個查詢，例如’user’和’users’。每個查詢都需要指定其類型和解析器，解析器在檢測到查詢時將被調(diào)用。
然后，我們需要通過POST請求將查詢發(fā)送到API中，并解析響應(yīng)數(shù)據(jù)。以上述代碼為例，我們會從API中獲取響應(yīng)JSON對象并直接輸出。
總結(jié)
在本文中，我們介紹了如何使用PHP創(chuàng)建GraphQL API。我們討論了GraphQL API的工作原理，并提供了一些示例代碼來演示如何創(chuàng)建類型、解析器并將其綁定到API中。我們還使用webonyx/graphql-php庫來簡化API的構(gòu)建和解析。如果您想了解更多關(guān)于GraphQL的信息，請參考GraphQL官方文檔。
