GraphQL

Leitura Inicial

• Oficial Learn
• GraphQL Basics - Fun Fun Function
• More GraphQL - Fun Fun Function
• Do We Need GraphQL?
• GraphQL: 3 reasons not to use it
• GraphQL and PHP

Dúvidas

• Overengineering?
• É bom para...?
• Como documentar os filtros/atributos...?
• Como explicar pra quem vai consumir?
• Exportar para o Elastic Search não é mais simples?
• Qual impacto real no consumo dessas infos versus mais code?
• HTTP caching e CDNs?
• Versioning?

Anotações

• API aggregation
• Schema que precisa ser definido
  • toda a lógica aqui
  • basicamente é o response da(s) API(s) "filtrado"
  • cuidado para não ficar "pesado"
    • Lazy Fetch
• Não substitui uma API, mas encapsula para expor dados
• Arguments para idiomas, unidades e conversões para um mesmo atributo
• Aliases podem ser interessantes porém adiciona um complexidade de manutenção, acho.
• Deprecated fields

Extensão para testar no Browser

• ChromeiQL
• Chrome Extension for Opera

Referências

• PokePHP
• graphql-php

POC

• Buscar Pokemon por número
  • 1 request
  • https://pokeapi.co/api/v2/pokemon/6/
• Buscar cadeia de evolução do pokemon
  • 3 requests
  • https://pokeapi.co/api/v2/pokemon/6/
  • https://pokeapi.co/api/v2/pokemon-species/6/
  • https://pokeapi.co/api/v2/evolution-chain/2/

Run Project

• Clonar Repo

• Rodar composer install --no-dev

• Rodar o server local PHP php -S localhost:4242 public/index.php

• Abrir o ChromeiQL e definir o endpoint localhost:4242

Testar

• Exemplos de Query:

{
  pokemon(number: 6)
}

{
  pokemon(number: 6) {
    name
  }
}

{
  pokemon(number: 6) {
    number
    name
    type
    evolutions
  }
}

{
  pokemon(number: 6) {
    number
    name
    type
    evolutions {
      name
    }
  }
}