🥳 Gato GraphQL v0.9이 출시되었습니다!

약 1.5년의 개발 기간과 16,000개 이상의 커밋을 거쳐, Gato GraphQL의 새 버전이 드디어 출시되었습니다! 🥳

버전 0.9은 플러그인 역사상 가장 큰 릴리스입니다. 변경 로그는 여기에서 확인하실 수 있으며, 모든 새 기능의 전체 내역은 다음과 같습니다:

github.com/GatoGraphQL/GatoGraphQL/releases/tag/0.9.3

이 문서는 매우 길기 때문에 (읽는 데 40분 이상 소요!), 아래에 가장 중요한 변경 사항의 TL;DR을 정리했습니다.

​

GraphQL 스키마의 대폭 확충

WordPress 데이터 모델이 GraphQL 스키마에 대폭 매핑되었습니다.

그 중에서도 스키마에는 다음과 같은 개선 사항이 포함되어 있습니다:

• 테마 및 플러그인을 포함한 모든 CPT에서 데이터 쿼리 가능
• 커스텀 택소노미(태그와 카테고리) 매핑
• 더 적합한 GraphQL 타입 생성 및 반환 (예: HTML, URL, DateTime)
• 인풋 객체를 통한 필드 인수 정리
• oneof 인풋 객체를 사용하여 다양한 속성(예: id, slug)으로 엔티티 선택
• 뮤테이션 페이로드 반환
• 설정(wp_options로부터) 및 메타 값(포스트, 사용자, 댓글, 택소노미용) 쿼리

​

커스텀 스칼라

GraphQL 서버에 커스텀 스칼라 타입 지원이 추가되었습니다. 커스텀 스칼라를 사용하면 필드 인수를 통한 입력 수신이나 응답에서의 커스텀 출력 인쇄 등 데이터를 더 적절하게 표현할 수 있습니다.

여러 표준 커스텀 스칼라 타입이 구현되어 GraphQL 스키마에서 즉시 사용 가능합니다:

• Date
• DateTime
• Email
• HTML
• URL
• URLAbsolutePath

​

커스텀 enum

커스텀 enum 타입이 이제 지원됩니다. enum은 특정 허용 값의 집합으로 제한된 특수한 종류의 스칼라입니다. 이를 통해 다음이 가능해집니다:

• 이 타입의 인수가 허용된 값 중 하나인지 유효성 검사
• 타입 시스템을 통해 필드가 항상 유한한 값의 집합 중 하나임을 전달

여러 enum 타입이 구현되어 GraphQL 스키마에서 적절한 곳에 사용됩니다. 다음이 포함됩니다:

• CommentOrderByEnum
• CommentStatusEnum
• CommentTypeEnum
• CustomPostOrderByEnum
• CustomPostStatusEnum
• MediaItemOrderByEnum
• MenuOrderByEnum
• TaxonomyOrderByEnum
• UserOrderByEnum

​

인풋 객체

GraphQL 서버는 이제 인풋 타입을 지원하며, 고유한 인풋 객체를 GraphQL 스키마에 추가할 수 있습니다. 인풋 객체를 사용하면 필드에 대한 입력으로 복잡한 객체를 전달할 수 있어, 뮤테이션에 특히 유용합니다.

스키마의 적절한 곳에 여러 인풋 객체가 추가되었습니다. 예를 들어 데이터를 쿼리하는 필드(posts, users, comments 등)는 필드 인수 filter, sort, pagination 아래에 복잡한 인풋 객체를 수신하고, 데이터를 변경하는 필드(createPost, addCommentToCustomPost 등)는 필드 인수 input 아래에 인풋 객체를 수신합니다.

​

Oneof 인풋 객체

「oneof」 인풋 객체는 특수한 인풋 객체로, 인풋 필드 중 정확히 하나만 입력으로 제공해야 하며, 그렇지 않으면 유효성 검사 오류가 반환됩니다. 이 동작은 입력에 다형성을 도입합니다.

예를 들어, 필드 Root.post에 필드 인수 by가 추가되었습니다. 이는 oneof 인풋 객체로, id나 slug 등 다양한 속성을 사용하여 포스트를 검색할 수 있습니다:

{
  postByID: post(by: {
    id: 1
  }) {
    id
    title
  }
 
  postBySlug: post(by: {
    slug: "hello-world"
  }) {
    id
    title
  }
}Copy

이 방식의 장점은 하나의 필드로 다양한 사용 사례를 처리할 수 있어, 각 사용 사례별로 별도의 필드(postByID, postBySlug 등)를 만들 필요가 없어지므로 GraphQL 스키마가 더 간결하고 우아해진다는 점입니다.

여러 Oneof 인풋 객체가 구현되었습니다:

• Root.customPost(by:)
• Root.mediaItem(by:)
• Root.menu(by:)
• Root.page(by:)
• Root.postCategory(by:)
• Root.postTag(by:)
• Root.post(by:)
• Root.user(by:)

​

오퍼레이션 디렉티브

GraphQL 오퍼레이션(즉, query 및 mutation 오퍼레이션)도 이제 디렉티브를 받을 수 있습니다.

​

특정 타입으로 디렉티브 제한

(필드) 디렉티브를 특정 타입의 필드에만 적용되도록 제한할 수 있습니다. 예를 들어, 필드 값을 대문자로 변환하는 디렉티브 @strUpperCase는 String 필드에만 의미가 있으며, Int, Float, Boolean에는 적용할 필요가 없습니다. 이 제한을 디렉티브 리졸버에서 선언할 수 있게 되었습니다.

​

오류를 발생시킨 GraphQL 쿼리 노드의 전체 경로 출력

응답에 오류를 반환한 GraphQL 쿼리의 노드에 대한 전체 경로가 포함되게 되었습니다(서브 엔트리 extensions.path 아래). 이를 통해 문제의 원인을 더 쉽게 파악할 수 있습니다.

예를 들어, 다음 쿼리에서 디렉티브 @nonExisting은 존재하지 않습니다:

query {
  myField @nonExisting
}Copy

응답은 다음과 같습니다:

{
  "errors": [
    {
      "message": "There is no directive with name 'nonExisting'",
      "locations": [
        {
          "line": 2,
          "column": 7
        }
      ],
      "extensions": {
        "type": "QueryRoot",
        "field": "myField @nonExisting",
        "path": [
          "@nonExisting",
          "myField @nonExisting",
          "query { ... }"
        ],
        "code": "PoP\\ComponentModel\\e20"
      }
    }
  ],
  "data": {
    "id": "root"
  }
}Copy

​

안전하지 않은 기본 설정 활성화

Gato GraphQL은 안전한 기본 설정을 제공합니다:

• 단일 엔드포인트가 비활성화됨
• GraphQL 스키마의 「민감한」 데이터 요소(예: User.roles 또는 status로 포스트 필터링)가 노출되지 않음
• 쿼리할 수 있는 설정 옵션 및 메타 키(포스트, 사용자 등)가 일부로 제한됨
• 한 번에 쿼리할 수 있는 엔티티 수가 제한됨(포스트, 사용자 등)

이러한 안전한 기본 설정은 악의적인 공격을 방지하기 위해 「라이브」 사이트를 안전하게 유지하는 데 필요합니다. 그러나 「스태틱」 사이트를 구축할 때(노트북의 개발 사이트, 안전한 방화벽 뒤, 또는 인터넷에 노출되지 않은 WordPress 사이트 등 공격에 취약하지 않은 경우)에는 필요하지 않습니다.

v0.9부터 wp-config.php에 다음을 추가하여 안전하지 않은 기본값을 활성화할 수 있습니다:

define( 'GRAPHQL_API_ENABLE_UNSAFE_DEFAULTS', true );Copy

또는 동일한 키/값을 환경 변수로 정의할 수도 있습니다.

안전하지 않은 기본값을 활성화하면 플러그인의 기본 설정이 다음과 같이 변경됩니다:

• 단일 엔드포인트가 활성화됨
• GraphQL 스키마에서 「민감한」 데이터 요소가 노출됨
• 모든 설정 옵션 및 메타 키를 쿼리할 수 있게 됨
• 한 번에 쿼리할 수 있는 엔티티 수가 무제한이 됨

​

카테고리별 커스텀 엔드포인트 및 Persisted 쿼리 정리

커스텀 엔드포인트 또는 Persisted 쿼리를 생성할 때, 모든 엔드포인트를 정리하기 위해 「GraphQL 엔드포인트 카테고리」를 추가할 수 있습니다:

예를 들어, 클라이언트, 애플리케이션 또는 기타 필요한 정보별로 엔드포인트를 관리하는 카테고리를 만들 수 있습니다:

커스텀 엔드포인트 및 Persisted 쿼리 목록에서 각 카테고리를 확인할 수 있습니다. 카테고리 링크를 클릭하거나 상단의 필터를 사용하면 해당 카테고리의 항목만 표시됩니다.

​

인트로스펙션을 통한 스키마 확장 쿼리

스키마 요소에 첨부된 커스텀 메타데이터를 이제 필드 extensions를 통해 쿼리할 수 있습니다.

스키마의 모든 인트로스펙션 요소가 새 필드로 업그레이드되어, 각각 해당하는 「Extensions」 타입의 객체를 반환하게 되었습니다. 이 타입은 해당 요소의 커스텀 속성을 노출합니다.

# Using "_" instead of "__" in introspection type name to avoid errors in graphql-js
type _SchemaExtensions {
  # Is the schema being namespaced?
  isNamespaced: Boolean!
}
 
extend type __Schema {
  extensions: _SchemaExtensions!
}
 
type _NamedTypeExtensions {
  # The type name
  elementName: String!
 
  # The "namespaced" type name
  namespacedName: String!
 
  # Enum-like "possible values" for EnumString type resolvers, `null` otherwise
  possibleValues: [String!]
 
  # OneOf Input Objects are a special variant of Input Objects where the type system asserts that exactly one of the fields must be set and non-null, all others being omitted.
  isOneOf: Boolean!
}
 
extend type __Type {
  # Non-null for named types, null for wrapping types (Non-Null and List)
  extensions: _NamedTypeExtensions
}
 
type _DirectiveExtensions {
  # If no objects are returned in the field (eg: because they failed validation), does the directive still need to be executed?
  needsDataToExecute: Boolean!
 
  # Names or descriptions of the types the field directives is restricted to, or `null` if it supports any type (i.e. it defines no restrictions)
  fieldDirectiveSupportedTypeNamesOrDescriptions: [String!]
}
 
extend type __Directive {
  extensions: _DirectiveExtensions!
}
 
type _FieldExtensions {
  isGlobal: Boolean!
 
  # Useful for nested mutations
  isMutation: Boolean!
 
  # `true` => Only exposed when "Expose "sensitive" data elements" is enabled
  isSensitiveDataElement: Boolean!
}
 
extend type __Field {
  extensions: _FieldExtensions!
}
 
type _InputValueExtensions {
  isSensitiveDataElement: Boolean!
}
 
extend type __InputValue {
  extensions: _InputValueExtensions!
}
 
type _EnumValueExtensions {
  isSensitiveDataElement: Boolean!
}
 
extend type __EnumValue {
  extensions: _EnumValueExtensions!
}Copy

​

GraphQL 서버 코드의 WordPress 분리 완료

플러그인을 구동하는 기반 GraphQL 서버는 이제 독립적인 PHP 컴포넌트로 설치 및 실행할 수 있습니다. 즉, WordPress와 독립적으로 동작합니다.

이를 통해 Gato GraphQL을 다른 프레임워크(예: Laravel)에서 사용하거나, WordPress의 사용 가능 여부에 관계없이(지속적 통합 작업 실행 시 등) 모든 PHP 환경에서 활용할 수 있는 길이 열립니다.

​

스키마 구성, 커스텀 엔드포인트, Persisted 쿼리 편집 시 문서 탐색

스키마 구성, 커스텀 엔드포인트, Persisted 쿼리 편집 시 표시되는 모든 블록에 「info」 버튼이 추가되었습니다. 클릭하면 모달 창에 문서가 표시됩니다.

​

그 외 더 많은 기능

다른 모든 새 기능을 확인하려면 새 릴리스의 전체 설명을 참조하시거나, 변경 로그를 살펴보세요.

그리고 여기에서 플러그인을 다운로드하세요.

마음에 드셨다면, 사랑을 널리 전파해 주세요 ❤️