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

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

1. GraphQL 라이브러리 설치

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

$ composer require webonyx/graphql-php

2. 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을 정의 및 내보내고 이 유형을 사용하여 스키마의 쿼리 항목을 지정합니다.

3. 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 형식으로 직렬화하여 클라이언트에 반환합니다.

4. 기능, 권한 및 인증

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

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

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

5. 컨텍스트 사용

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 중국어 웹사이트의 기타 관련 기사를 참조하세요!