PHP를 사용하여 GraphQL API를 생성하는 방법 알아보기: API 인터페이스 구축 단계

GraphQL은 API용 쿼리 언어로, 이를 통해 클라이언트는 데이터를 정확하게 쿼리하고 네트워크 대역폭과 서버 리소스 낭비를 피할 수 있습니다. 이번 글에서는 PHP를 사용하여 GraphQL API를 생성하는 방법에 대해 설명하겠습니다.

GraphQL API 작동 방식

GraphQL API는 쿼리 언어를 기반으로 합니다. 클라이언트는 서버에 쿼리 요청을 보내고, 서버는 요청을 구문 분석하여 해당 데이터를 반환합니다. 요청과 응답은 GraphQL 언어 형식으로 보내고 받습니다.

GraphQL API는 클라이언트가 일부 데이터를 쿼리한 다음 동일한 쿼리에서 관련 데이터를 요청할 수 있는 다중 레벨 관련 쿼리도 지원합니다. 이는 네트워크 대역폭과 서버 오버헤드를 크게 줄여줍니다.

GraphQL API에는 쿼리, 유형 및 파서라는 세 가지 주요 개념이 있습니다. 쿼리는 클라이언트가 보낸 요청이고, GraphQL 유형은 API에서 사용되는 개체이며, 확인자는 요청을 응답으로 변환하는 코드입니다.

GraphQL API 만들기

PHP를 사용하여 GraphQL API를 구현하고 webonyx/graphql-php 라이브러리를 사용하여 쿼리를 작성하고 구문 분석합니다.

먼저 API의 개체를 설명하는 몇 가지 GraphQL 유형을 만들어야 합니다. 다음은 User 유형의 예입니다.

use GraphQLTypeDefinitionType;
use GraphQLTypeDefinitionObjectType;

$userType = new ObjectType([
    'name' => 'User',
    'fields' => [
        'id' => Type::int(),
        'name' => Type::string(),
        'email' => Type::string()
    ]
]);

위 코드는 id, name 및 email의 세 가지 필드가 있는 User라는 유형을 만듭니다. 각 필드에는 유형이 있으며 Type::int()는 정수 유형을 나타내고 Type::string()은 문자열 유형을 나타냅니다.

다음으로 쿼리를 처리할 파서를 만들어야 합니다. 다음은 샘플 사용자 쿼리 파서입니다.

$rootValue = [
    'users' => [
        ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'],
        ['id' => 2, 'name' => 'Bob', 'email' => 'bob@example.com']
    ]
];

$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'];
    }
};

위 코드는 두 개의 사용자 개체가 포함된 $rootValue 배열을 만듭니다. $resolver 함수는 클라이언트가 보낸 요청에 따라 해당 데이터를 반환합니다. 요청에 id 매개변수가 있는 경우 해당 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());
}

위 코드는 사용자 유형과 해석기를 GraphQL API에 바인딩하고 쿼리 개체를 생성합니다. 쿼리 개체에서는 '사용자', '사용자' 등 여러 쿼리를 정의할 수 있습니다. 각 쿼리는 쿼리가 감지되면 호출될 해당 유형과 파서를 지정해야 합니다.

그런 다음 POST 요청을 통해 API에 쿼리를 보내고 응답 데이터를 구문 분석해야 합니다. 위 코드를 예로 들어 API에서 응답 JSON 객체를 가져와 직접 출력하겠습니다.

요약

이 글에서는 PHP를 사용하여 GraphQL API를 생성하는 방법을 다뤘습니다. GraphQL API의 작동 방식을 논의하고 유형, 해석기를 생성하고 이를 API에 바인딩하는 방법을 보여주기 위해 몇 가지 샘플 코드를 제공했습니다. 또한 webonyx/graphql-php 라이브러리를 사용하여 API 구축 및 구문 분석을 단순화합니다. GraphQL에 대해 더 알고 싶다면 공식 GraphQL 문서를 참고하세요.

위 내용은 PHP를 사용하여 GraphQL API를 생성하는 방법 알아보기: API 인터페이스 구축 단계의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!