GraphQL на PHP: Apollo Federation и подкасты. Создание распределенных схем для масштабируемых проектов

Сегодня я хочу поделиться с вами опытом создания распределенных GraphQL-схем с использованием Apollo Federation на PHP. Мы разберем, как строить микросервисные архитектуры для проектов вроде подкаст-платформ, где гибкость и масштабируемость критически важны.

Почему Apollo Federation и GraphQL?

У вас есть платформа для подкастов с тысячами эпизодов, пользователей и рекомендаций. Каждый сервис (пользователи, контент, аналитика) разрабатывается отдельной командой. Как объединить их в единое API?

REST API здесь часто проигрывает из-за избыточных запросов и жесткой связности. Классический GraphQL с монолитной схемой тоже не идеален, изменения в одном сервисе могут сломать всю систему.

Apollo Federation решает эти проблемы, позволяя создавать распределенные схемы. Каждый микросервис определяет свою часть GraphQL-схемы, а Federation объединяет их в единое целое.

Настройка Apollo Federation на PHP: шаг за шагом

Шаг 1. Выбор инструментов

Для PHP я рекомендую связку:

• webonyx/graphql-php — ядро GraphQL.
• Apollo Federation SDK для PHP — добавление директив @key, @extends.

Установка:

composer require webonyx/graphql-php  
composer require apollographql/federation-php

Шаг 2. Создание сервиса «Подкасты»

Опишем схему для сервиса, отвечающего за эпизоды и шоу.

schema.graphql

type Podcast @key(fields: "id") {  
  id: ID!  
  title: String!  
  episodes: [Episode!]!  
}  

type Episode {  
  id: ID!  
  title: String!  
  duration: Int!  
}  

type Query {  
  podcasts: [Podcast!]!  
}

PHP-реализация:

use GraphQL\Type\Definition\ObjectType;  
use GraphQL\Type\Definition\Type;  

$podcastType = new ObjectType([  
  'name' => 'Podcast',  
  'fields' => [  
    'id' => Type::id(),  
    'title' => Type::string(),  
    'episodes' => function() use ($episodeType) {  
      return [  
        'type' => Type::listOf($episodeType),  
        'resolve' => function($podcast) {  
          // Запрос к БД или другому сервису  
        }  
      ];  
    }  
  ]  
]);

Шаг 3. Сервис «Пользователи» с расширением схемы

Добавим информацию о создателях подкастов.

schema.graphql

type User @key(fields: "id") @extends {  
  id: ID! @external  
  createdPodcasts: [Podcast!]!  
}

PHP-код:

$userType = new ObjectType([  
  'name' => 'User',  
  'fields' => [  
    'id' => Type::id(),  
    'createdPodcasts' => [  
      'type' => Type::listOf($podcastType),  
      'resolve' => function($user) {  
        // Запрос к сервису подкастов по userId  
      }  
    ]  
  ]  
]);

Apollo Federation или REST или Monolithic GraphQL

Рекомендации для разработчиков

1. Используйте Federation, если:
   • Ваш проект состоит из независимых микросервисов.
   • Нужно избегать «гигантской» схемы GraphQL.
2. Оптимизируйте резолверы:
   • Для полей, требующих запросов к другим сервисам, используйте DataLoader.
3. Тестируйте производительность:
   • Проверяйте время ответа для распределенных запросов.
   • Используйте кэширование на уровне GraphQL.

Apollo Federation на PHP открывает новые возможности для создания гибких API. Для подкаст-платформ, где данные распределены между сервисами это идеальный выбор.