🚀 Gato GraphQL v18.0 출시: 파싱된 쿼리 캐싱, 강화된 보안, 새로운 Gemini 번역 공급자

Gato GraphQL v18.0이 출시되었습니다 🎉

이번 릴리스는 처리 속도가 눈에 띄게 빨라지고 메모리 사용량이 크게 줄었으며, 반복적인 파싱 및 컴파일 작업을 건너뛰기 위해 파싱된 GraphQL 쿼리를 디스크에 캐시할 수 있게 되었습니다. 또한 Email Sender·HTTP Client·Environment Variable 필드의 기본 capability 검사가 강화되고, 여러 버그 수정 및 보안 패치가 포함되었으며, 새로운 Gemini 번역 공급자와 번역용 설정 가능한 Request 및 Connection 타임아웃이 추가되었습니다.

주요 내용을 살펴보세요.

​

⚡ 파싱된 GraphQL 쿼리를 디스크에 캐시

모든 요청은 GraphQL 쿼리를 파싱하고, 스키마에 대해 유효성을 검사하며, 실행 계획을 구축해야 합니다. v18에서는 준비된 쿼리를 디스크에 저장하고 이후 실행 시 다시 불러옴으로써 반복적인 파싱 및 컴파일 작업을 완전히 건너뛸 수 있게 되었습니다.

Settings 페이지의 Server Configuration > Caching > Cache parsed GraphQL queries? 에서 활성화할 수 있습니다:

이것은 쿼리의 준비 처리(파싱 및 컴파일)를 캐시하는 것이지, 응답 데이터를 캐시하는 것이 아닙니다. 응답의 HTTP 캐싱에 대해서는 HTTP 캐싱 추가하기를 참조하세요.

파일은 플러그인 캐시 디렉터리에 저장됩니다. 플러그인 폴더에 쓰기 권한이 없는 경우 캐시 저장 위치를 변경할 수 있습니다 — 캐시 폴더 재정의하기를 참조하세요.

➡️ 자세한 내용은 파싱된 GraphQL 쿼리 캐싱을 참조하세요.

​

⚡ 전반적인 고속화 및 경량화

파싱된 쿼리 캐시 외에도, v18에서는 플러그인 내부 처리가 전면적으로 개선되었습니다: 모든 GraphQL 요청이 눈에 띄게 빨라지고, 메모리 사용량이 크게 줄었습니다.

이 개선은 전체적으로 적용되어 모든 쿼리, 모든 디렉티브, 모든 persisted query에 영향을 미칩니다. 특히 대규모 스키마, 긴 쿼리, 페이지당 많은 GraphQL 요청을 실행하는 사이트(예: 헤드리스 WordPress, 내부 API)에서 두드러진 효과를 발휘합니다.

이전에 PHP 메모리 한도에 부딪히거나 응답이 느렸던 대규모 사이트에서는 설정 변경 없이 실질적인 차이를 느낄 수 있을 것입니다 — 플러그인만 업데이트하면 됩니다.

​

🔒 보안 기본값 강화

플러그인을 기본적으로 더 안전하게 만들기 위해 세 가지 영역에서 기본 설정이 강화되었습니다.

​

Email Sender — 필요한 capability

_sendEmail mutation은 이제 Plugin Configuration > Email Sender에서 설정된 특정 WordPress capability를 가진 사용자로 제한할 수 있습니다.

기본값은 manage_options이므로 구독자가 mutation을 사용하여 임의의 수신자에게 스팸을 보낼 수 없습니다. 검사를 비활성화하려면 **(any logged-in user)**를 선택하세요.

​

HTTP Client — 내부 URL 접근에 필요한 capability

일부 URL은 내부 주소(127.0.0.1, 링크-로컬 범위, 클라우드 메타데이터 엔드포인트 등)로 해석되어 접근 시 내부 서비스가 노출될 수 있습니다. Plugin Configuration > HTTP Client의 새 설정을 통해 해당 주소에 대한 접근을 특정 WordPress capability를 가진 사용자로 제한할 수 있습니다.

기본값은 manage_options이므로 비관리자 사용자가 HTTP Client 필드를 통해 내부 서비스에 접근할 수 없습니다. 검사를 비활성화하려면 **(any logged-in user)**를 선택하세요.

​

Environment Variables — 비관리자 사용자를 위한 denylist

_env 필드는 이미 명시적인 allow-list를 필요로 하며, 해당 목록은 기본적으로 비어 있습니다. v18에서는 비관리자 사용자를 위한 추가 안전망이 도입되었습니다: 이러한 이름이 설정의 allow-list에 포함되어 있더라도 접근이 거부됩니다.

항상 거부됨 (WordPress 시크릿):

AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT, NONCE_SALT, DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_CHARSET, DB_COLLATE.

또한 거부됨 — 이름에 다음을 포함하는 변수: PASSWORD, PASSWD, SECRET, PRIVATE_KEY, API_KEY, APIKEY, ACCESS_KEY, ACCESS_TOKEN, AUTH_TOKEN, BEARER, CREDENTIAL, SALT.

관리자 사용자는 계속해서 전체 접근 권한을 가집니다.

➡️ 전체 목록은 문서의 보안 섹션을 참조하세요.

​

🌐 번역: 새로운 Gemini 공급자

@strTranslate 디렉티브가 ChatGPT, Claude, DeepL, DeepSeek, Google Translate, Mistral, OpenRouter 및 셀프 호스팅 LLM과 함께 번역 공급자로 Google Gemini를 지원하게 되었습니다.

모든 String 필드를 원하는 언어로 번역할 수 있습니다:

{
  posts {
    title @strTranslate(
      from: "en",
      to: "fr",
      provider: gemini
    )
 
    content @strTranslate(
      from: "en",
      to: "fr",
      provider: gemini
    )
  }
}Copy

다음 Gemini 모델이 지원됩니다:

• Gemini 2.0 Flash (gemini-2.0-flash)
• Gemini 2.0 Flash-Lite (gemini-2.0-flash-lite)
• Gemini 2.5 Flash (gemini-2.5-flash)
• Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
• Gemini 2.5 Pro (gemini-2.5-pro)
• Gemini 3.1 Flash-Lite (gemini-3.1-flash-lite)

Google API 키를 설정하고(Settings, wp-config.php, 또는 환경 변수를 통해), 모델을 선택하면 번역 준비가 완료됩니다.

➡️ Gemini 번역 레퍼런스 문서를 참조하세요.

​

⏱️ 번역: Request 및 Connection 타임아웃

긴 문서를 서드파티 공급자를 통해 번역하는 데는 시간이 걸릴 수 있으며, 업스트림이 응답하지 않으면 PHP가 요청을 강제 종료할 때까지 PHP 워커가 점유되어 일반적인 HTTP 502/504 오류나 빈 「Maximum execution time exceeded」 페이지가 표시될 수 있습니다.

v18에서는 Plugin Configuration > Translation에 두 가지 타임아웃 설정이 추가되었습니다:

• Request timeout: 번역 공급자로부터 전체 응답을 기다리는 최대 시간(초 단위).
• Connection timeout: 연결을 수립할 때 기다리는 최대 시간(초 단위).

서버의 일반 타임아웃이 발생하는 대신 번역이 중단될 때 로그에 제어된 오류로 기록되도록, 두 값 모두 서버의 max_execution_time보다 약간 낮게 설정하세요. 번역이 자주 타임아웃되는 경우, 두 값과 서버의 max_execution_time을 함께 높이세요.

​

🐛 버그 수정 및 보안 패치

위의 새 기능 외에도, v18.0에는 여러 버그 수정과 몇 가지 보안 취약점 패치도 포함되어 있습니다. 가능한 한 빨리 v18로 업데이트하실 것을 강력히 권장합니다.

​

업그레이드

릴리스는 현재 WordPress 플러그인 디렉터리와 고객 대시보드를 통해 배포 중입니다. WordPress 관리자 화면(플러그인 → 업데이트)에서 업데이트하거나, 계정에서 최신 버전을 다운로드하세요.

변경 사항의 전체 목록은 changelog를 참조하세요.

v18을 즐겨 사용하세요! 🎉