PHP에서 GraphQL을 사용하여 API 인터페이스를 만드는 방법-PHP 튜토리얼-php.cn

PHP에서 GraphQL을 사용하여 API 인터페이스를 만드는 방법

王林

풀어 주다： 2023-05-10 22:34:01

원래의

1566명이 탐색했습니다.

GraphQL은 클라이언트에 반환해야 하는 데이터를 정확하게 지정할 수 있는 새로운 API 쿼리 언어로, 이를 통해 서버의 불필요한 데이터 전송을 줄이고 네트워크 요청 및 데이터 전송의 효율성을 향상시킵니다. 기존 RESTful 스타일 API에 비해 GraphQL은 더 유연하고 효율적입니다. 이 기사에서는 PHP에서 GraphQL을 사용하여 API 인터페이스를 만드는 방법을 살펴보겠습니다.

GraphQL 라이브러리 설치

GraphQL을 사용하기 전에 GraphQL 관련 라이브러리를 설치해야 합니다. PHP에서 가장 널리 사용되는 GraphQL 라이브러리는 webonyx/graphql-php입니다. Composer를 통해 설치할 수 있습니다. 구체적인 작업은 다음과 같습니다.

$ composer require webonyx/graphql-php

로그인 후 복사

Create Schema

GraphQL에서 스키마는 데이터 모델과 쿼리 문을 정의합니다. 스키마는 GraphQL의 핵심 부분입니다. GraphQL-php는 GraphQLTypeSchema 클래스를 사용하여 스키마를 생성합니다. 예를 들어 다음은 간단한 스키마 정의입니다.

use GraphQLTypeDefinitionType;
use GraphQLTypeSchema;

$queryType = new GraphQLTypeDefinitionObjectType([
    'name' => 'Query',
    'fields' => [
        'message' => [
            'type' => Type::string(),
            'resolve' => function() {
                return 'Hello, World!';
            }
        ],
    ]
]);

$schema = new Schema([
    'query' => $queryType
]);

로그인 후 복사

이 예에서는 하나의 필드를 포함하는 쿼리 유형을 정의합니다. 이 필드는 메시지라고 하며 Hello, World! 문자열을 반환합니다. 스키마에서는 queryType을 정의 및 내보내고 이 유형을 사용하여 스키마의 쿼리 항목을 지정합니다.

GraphQL 요청 처리

스키마가 정의되면 GraphQL 요청 처리를 시작할 수 있습니다. GraphQL의 PHP 라이브러리를 사용하여 요청을 처리할 수 있습니다. 그 중 GraphQLServerStandardServer 클래스는 서버 구현을 제공하고 요청을 스키마 핸들러로 라우팅하여 응답 결과를 얻습니다. GraphQL 요청을 처리하는 기본 단계는 다음과 같습니다.

요청 매개변수 가져오기
요청 매개변수를 GraphQL 쿼리로 구문 분석
요청 실행
결과 반환

다음은 처리를 위한 기본 예제 코드입니다. GraphQL 요청:

use GraphQLServerStandardServer;

// 获取请求参数
$request = json_decode(file_get_contents('php://input'), true);

// 将请求参数解析为GraphQL查询
$query = isset($request['query']) ? $request['query'] : null;
$variables = isset($request['variables']) ? $request['variables'] : null;

// 执行请求
$server = new StandardServer([
    'schema' => $schema,
    'debug' => true,
]);
$result = $server->executePsrRequest(Request::fromGlobals(), $query, [], $variables);

// 返回结果
echo json_encode($result);

로그인 후 복사

이 예에서는 먼저 요청 매개변수를 가져옵니다. 그런 다음 요청 매개변수는 GraphQL 쿼리로 구문 분석되고 StandardServer를 통해 실행됩니다. 마지막으로 반환 결과를 JSON 형식으로 직렬화하여 클라이언트에 반환합니다.

기능, 권한 및 인증

GraphQL API의 기능을 향상시키기 위해 "기능"과 "권한"을 추가할 수 있습니다. 이러한 기능에 대한 GraphQL의 지원은 매우 강력합니다. 예를 들어 GraphQL의 "강제 유형 검사"를 사용하여 각 필드에 올바른 데이터 유형이 있는지 확인할 수 있습니다. 또한 GraphQL의 "스키마 유효성 검사"를 사용하여 각 필드가 존재하고 우리가 정의한 유형을 준수하는지 확인할 수 있습니다.

동시에 데이터 보안을 보호하기 위해 API에 "권한"을 추가해야 할 수도 있습니다. "권한"은 사용자가 데이터베이스의 특정 데이터에 액세스할 수 있는 권한이 있는지 확인하는 것입니다. GraphQL은 권한 제어 요구 사항을 구현하는 다양한 방법을 제공합니다. 예를 들어 스키마를 정의할 때 강력한 역할 기반 액세스 제어를 정의할 수 있습니다.

인증은 웹 애플리케이션 인증의 일부이며 사용자의 신원을 감지하는 데 사용됩니다. 인증은 GraphQL에서도 지원됩니다. 요청을 처리할 때 사용자가 유효한 인증 방법을 가지고 있는지 확인하여 API의 보안을 보장할 수 있습니다. 인증을 구현할 때 사용자의 신원 정보를 각 요청에 매개변수로 전달할 수도 있습니다.

컨텍스트 사용

GraphQL은 데이터에 액세스하거나 업데이트할 때 필요한 임시 상태 또는 속성 문제를 해결하기 위해 "컨텍스트" 개념을 도입합니다. 컨텍스트는 일반적으로 GraphQL 작업에 연결된 영구 저장소 또는 캐시이지만 현재 사용자에 대한 인증 데이터 및 요청 데이터와 같은 임의의 유용한 정보를 포함할 수도 있습니다.

PHP에서는 컨텍스트에 매개변수를 추가하여 모든 요청에 데이터를 전달할 수 있습니다. 예를 들어 기본 예는 다음과 같습니다.

$context = [
    'db' => $db,
    'currentUser' => $currentUser,
];

$server = new StandardServer([
    'schema' => $schema,
    'context' => $context,
]);

$result = $server->processPsrRequest($request, $response);

로그인 후 복사

이 예에서는 "context"라는 변수를 정의하고 해당 변수를 요청 핸들러에 추가합니다. 이렇게 하면 모든 요청이 해당 컨텍스트에 액세스하고 여기에 포함된 정보를 사용할 수 있습니다.

요약

PHP에서 GraphQL을 사용하여 API 인터페이스를 생성하려면 GraphQL 라이브러리를 설치하고, 스키마를 정의하고, GraphQL 요청을 처리하고, 권한 및 인증을 구현하고, 컨텍스트를 사용하여 정보를 전달해야 합니다. GraphQL의 진정한 가치는 데이터를 쿼리하고 운영하는 유연하고 효율적인 방법을 제공하여 개발자가 보다 우아하고 효율적인 API를 만들 수 있도록 돕는 것입니다. 이 기사가 독자들이 GraphQL을 더 잘 이해하고 배우고 이를 사용하여 PHP에서 놀라운 API를 구축하는 데 도움이 되기를 바랍니다.

위 내용은 PHP에서 GraphQL을 사용하여 API 인터페이스를 만드는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!