Transferir como PDF, PPTX
![GET /news/1/comments
[
{
"id": "25",
"news_id": "1",
"text": "Não sou faixa preta cumpadi, sou preto inteiris.",
"created_at": "1495928417",
"author": {
"name": "Nissim Ourfali",
"email": "nissimourfali@locaweb.com"
}
}, //... a lot of comments
]](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-7-320.jpg)
![{
news(id: 1) {
title, text, created_at,
media {
url
},
user {
name
},
comments {
text,
author {
name
}
}
}
}
[
{
"title": "Joesley rompe com Tony Ramos",
"text": "Mussum, Ipsum, cacilds vidis...",
"created_at": "1495928417",
"media": {
"url":"http://news/media/65815736...
},
"user": {
"name": "Mad Max"
},
"comments": [
//...
]
}
]](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-11-320.jpg)
![$userType = new ObjectType([
'name' => 'User',
'fields' => [
'id' => Type::nonNull(Type::id()),
'name' => Type::nonNull(Type::string()),
'email' => Type::nonNull(Type::string()),
'role' => Type::nonNull(Type::string()),
'created_at' => Type::nonNull(Type::int())
]
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-27-320.jpg)
![$mediaType = new ObjectType([
'name' => 'Media',
'fields' => [
'id' => Type::nonNull(Type::id()),
'type' => Type::nonNull(Type::string()),
'filename' => Type::nonNull(Type::string()),
'size' => Type::nonNull(Type::string()),
'url' => Type::nonNull(Type::string())
]
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-28-320.jpg)
![$commentType = new ObjectType([
'name' => 'Comment',
'fields' => [
'id' => Type::nonNull(Type::id()),
'text' => Type::nonNull(Type::string()),
'created_at' => Type::nonNull(Type::int()),
'author' => Type::nonNull(new ObjectType([
'name' => 'Author',
'fields' => [
'name' => Type::string(),
'email' => Type::string()
]
]))
]
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-29-320.jpg)
![$newsType = new ObjectType([
'name' => 'News',
'fields' => [
'id' => Type::nonNull(Type::id()),
'user' => Type::nonNull($userType),
'media' => $mediaType,
'title' => Type::nonNull(Type::string()),
'excerpt' => Type::string(),
'text' => Type::nonNull(Type::string()),
'created_at' => Type::nonNull(Type::int()),
'status' => Type::nonNull(Type::string()),
'comments' => Type::listOf($commentType)
]
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-30-320.jpg)
![$mutationType = new ObjectType([
'name' => 'Mutation',
'fields' => [
'registerUser' => $registerUserMutation,
'registerComment' => $registerCommentMutation,
'reportContent' => $reportContentMutation
]
]);
$queryType = new ObjectType([
'name' => 'Query',
'fields' => [
'news' => $newsQuery,
'categories' => $categoriesQuery,
'users' => $usersQuery
],
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-38-320.jpg)
![$schema = new Schema([
'query' => $queryType,
'mutation' => $mutationType
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-39-320.jpg)
![query{
news(id: 1) {
title, text, created_at,
media {
url
},
user {
name
},
comments {
text,
author {
name
}
}
}
}
$newsQuery = [
'type' => Type::listOf($newsType),
'args' => [
'id' => Type::id()
],
'resolve' => function ($root, $args) {
if ($args['id'] ?? false) {
return NewsRepository::findBy(
['id' => $args['id']]
);
}
return NewsRepository::findAll();
}
];](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-42-320.jpg)
![$registerUserMutation = [
'type' => $userType,
'args' => [
'name' => Type::nonNull(Type::string()),
'email' => Type::nonNull(Type::string()),
],
'resolve' => function ($root, $args) {
return NewsRepository::add($args);
}
];
mutation{
registerUser(
name: "Mark",
email: "mark@locaweb.com"
) {
id,
name,
email,
role,
created_at
}
}](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-45-320.jpg)
![mutation{
registerUser(name: 1) {
undefined_field
}
}
{
"errors": [
{
"message": "Argument "name" has invalid value 1.nExpected
type "String", found 1.",
"locations": [
{
"line": 2,
"column": 22
}
]
},
{
"message": "Cannot query field "undefined_field" on type
"User".",
"locations": [
{
"line": 3,
"column": 5
}
]
}
]
}](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-48-320.jpg)
![$newsQuery = [
'type' => Type::listOf($newsType),
'args' => [
'id' => Type::id()
],
'resolve' => function ($root, $args) {
if ($args['id'] ?? false) {
return NewsRepository::findBy(
['id' => $args['id']]
);
}
return NewsRepository::findAll();
}
];](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-53-320.jpg)
![$newsType = new ObjectType([
'name' => 'News',
'fields' => [
'id' => Type::nonNull(Type::id()),
'user' => Type::nonNull($userType),
'media' => $mediaType,
'title' => Type::nonNull(Type::string()),
'excerpt' => [
'type' => Type::nonNull(Type::string()),
'resolve' => function ($news, $args) {
return 'Excerpt from: ' . $news->title;
}
],
'text' => Type::nonNull(Type::string()),
'created_at' => Type::nonNull(Type::int()),
'status' => Type::nonNull(Type::string()),
'comments' => Type::listOf($commentType )
]
]);](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-54-320.jpg)
![query {
news(id:1) {
id
title
excerpt
}
}
{
"data": {
"news": [
{
"id": "1",
"title": "Joesley rompe com ..." ,
"excerpt": "Excerpt from: Joesley
rompe com Tony Ramos"
}
]
}
}](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-55-320.jpg)
![{
__type(name: "News") {
name
fields {
name
}
}
}
{
"data": {
"__type": {
"name": "News",
"fields": [
{ "name": "id" },
{ "name": "user" },
{ "name": "media" },
{ "name": "title" }
//...
]
}
}
}](https://image.slidesharecdn.com/phpsummit-dorestaographqlcomphp-170904000336/85/PHP-Community-Summit-Do-REST-ao-GraphQL-com-PHP-66-320.jpg)
Carregado porBruno Neves Menezes
PHP Community Summit - Do REST ao GraphQL com PHP
O documento apresenta GraphQL como uma alternativa ao REST para desenvolvimento de APIs com PHP. Resume a história, especificação e linguagem do GraphQL e demonstra como modelar um schema, queries e mutações para uma aplicação de notícias usando o framework GraphQL para PHP.
PHP Community Summit - Do REST ao GraphQL com PHP
- 1. Do REST aoGraphQL com PHP BRUNO NEVES brunonm@gmail.com @brunodasneves
- 2. Roteiro REST & GraphQL História Especificação/ Linguagem PHP
- 3.
- 4. GET /news/1 { "id": "1", "user_id":"57", "media_id": "20", "title": "Joesley rompe com Tony Ramos", "excerpt": "Mussum, Ipsum, cacilds", "text": "Mussum, Ipsum, cacilds vidis litro abertis...", "created_at": "1495928417", "status": "PUBLISHED" }
- 5. GET /users/57 { "id": "57", "name":"Mad Max", "email": "madmax@locaweb.com", "role": "WRITER", "created_at": "1495928417" }
- 6. GET /medias/20 { "id": "20", "type":"image/jpeg", "filename": "friboi.jpg", "size": "204800", "url": "http://news/media/65815736d29cc094a2d784c338066029" }
- 7. GET /news/1/comments [ { "id": "25", "news_id":"1", "text": "Não sou faixa preta cumpadi, sou preto inteiris.", "created_at": "1495928417", "author": { "name": "Nissim Ourfali", "email": "nissimourfali@locaweb.com" } }, //... a lot of comments ]
- 8.
- 9. Como seria pedir SOMENTE onecessário e receber EXATAMENTE o que pediu de UMA SÓ VEZ?
- 10. { news(id: 1) { title,text, created_at, media { url }, user { name }, comments { text, author { name } } } }
- 11. { news(id: 1) { title,text, created_at, media { url }, user { name }, comments { text, author { name } } } } [ { "title": "Joesley rompe com Tony Ramos", "text": "Mussum, Ipsum, cacilds vidis...", "created_at": "1495928417", "media": { "url":"http://news/media/65815736... }, "user": { "name": "Mad Max" }, "comments": [ //... ] } ]
- 13.
- 14.
- 15. História Facebook Newsfeed APIpara iOS Agosto 2012
- 16.
- 17.
- 18.
- 19.
- 20.
- 21.
- 22.
- 23. $ composer requirewebonyx/graphql-php http://webonyx.github.io/graphql-php/
- 24.
- 25.
- 26.
- 27. $userType = newObjectType([ 'name' => 'User', 'fields' => [ 'id' => Type::nonNull(Type::id()), 'name' => Type::nonNull(Type::string()), 'email' => Type::nonNull(Type::string()), 'role' => Type::nonNull(Type::string()), 'created_at' => Type::nonNull(Type::int()) ] ]);
- 28. $mediaType = newObjectType([ 'name' => 'Media', 'fields' => [ 'id' => Type::nonNull(Type::id()), 'type' => Type::nonNull(Type::string()), 'filename' => Type::nonNull(Type::string()), 'size' => Type::nonNull(Type::string()), 'url' => Type::nonNull(Type::string()) ] ]);
- 29. $commentType = newObjectType([ 'name' => 'Comment', 'fields' => [ 'id' => Type::nonNull(Type::id()), 'text' => Type::nonNull(Type::string()), 'created_at' => Type::nonNull(Type::int()), 'author' => Type::nonNull(new ObjectType([ 'name' => 'Author', 'fields' => [ 'name' => Type::string(), 'email' => Type::string() ] ])) ] ]);
- 30. $newsType = newObjectType([ 'name' => 'News', 'fields' => [ 'id' => Type::nonNull(Type::id()), 'user' => Type::nonNull($userType), 'media' => $mediaType, 'title' => Type::nonNull(Type::string()), 'excerpt' => Type::string(), 'text' => Type::nonNull(Type::string()), 'created_at' => Type::nonNull(Type::int()), 'status' => Type::nonNull(Type::string()), 'comments' => Type::listOf($commentType) ] ]);
- 31. Um serviço GraphQL é compostopor TYPES, que por sua vez são compostos por FIELDS
- 32.
- 33.
- 34.
- 35.
- 36. São tipos especiaisde objetos que ficam na raiz do schema
- 37. Enquanto a MUTATION éopcional, a QUERY deve estar presente em todo schema GraphQL
- 38. $mutationType = newObjectType([ 'name' => 'Mutation', 'fields' => [ 'registerUser' => $registerUserMutation, 'registerComment' => $registerCommentMutation, 'reportContent' => $reportContentMutation ] ]); $queryType = new ObjectType([ 'name' => 'Query', 'fields' => [ 'news' => $newsQuery, 'categories' => $categoriesQuery, 'users' => $usersQuery ], ]);
- 39. $schema = newSchema([ 'query' => $queryType, 'mutation' => $mutationType ]);
- 40.
- 41. QUERY são operações de consultano serviço
- 42. query{ news(id: 1) { title,text, created_at, media { url }, user { name }, comments { text, author { name } } } } $newsQuery = [ 'type' => Type::listOf($newsType), 'args' => [ 'id' => Type::id() ], 'resolve' => function ($root, $args) { if ($args['id'] ?? false) { return NewsRepository::findBy( ['id' => $args['id']] ); } return NewsRepository::findAll(); } ];
- 43. MUTATION são operações que modificamos dados no serviço
- 44.
- 45. $registerUserMutation = [ 'type'=> $userType, 'args' => [ 'name' => Type::nonNull(Type::string()), 'email' => Type::nonNull(Type::string()), ], 'resolve' => function ($root, $args) { return NewsRepository::add($args); } ]; mutation{ registerUser( name: "Mark", email: "mark@locaweb.com" ) { id, name, email, role, created_at } }
- 46.
- 47. Todo dado queentra e sai de um serviço GraphQL é validado no SCHEMA
- 48. mutation{ registerUser(name: 1) { undefined_field } } { "errors":[ { "message": "Argument "name" has invalid value 1.nExpected type "String", found 1.", "locations": [ { "line": 2, "column": 22 } ] }, { "message": "Cannot query field "undefined_field" on type "User".", "locations": [ { "line": 3, "column": 5 } ] } ] }
- 49.
- 50. São os responsáveispor resolver a QUERY, ou MUTATION, e retornar as informações
- 51. Todo FIELD possuium RESOLVER, mesmo que de forma implícita
- 52. O RESOLVER deum FIELD filho recebe o resultado do FIELD pai como argumento
- 53. $newsQuery = [ 'type'=> Type::listOf($newsType), 'args' => [ 'id' => Type::id() ], 'resolve' => function ($root, $args) { if ($args['id'] ?? false) { return NewsRepository::findBy( ['id' => $args['id']] ); } return NewsRepository::findAll(); } ];
- 54. $newsType = newObjectType([ 'name' => 'News', 'fields' => [ 'id' => Type::nonNull(Type::id()), 'user' => Type::nonNull($userType), 'media' => $mediaType, 'title' => Type::nonNull(Type::string()), 'excerpt' => [ 'type' => Type::nonNull(Type::string()), 'resolve' => function ($news, $args) { return 'Excerpt from: ' . $news->title; } ], 'text' => Type::nonNull(Type::string()), 'created_at' => Type::nonNull(Type::int()), 'status' => Type::nonNull(Type::string()), 'comments' => Type::listOf($commentType ) ] ]);
- 55. query { news(id:1) { id title excerpt } } { "data":{ "news": [ { "id": "1", "title": "Joesley rompe com ..." , "excerpt": "Excerpt from: Joesley rompe com Tony Ramos" } ] } }
- 56.
- 57. Quando um FIELDfor depreciado, é sinalizada a mudança no SCHEMA e definido o substituto
- 58.
- 59.
- 60. Entrega mais poderde fogo para o frontend
- 61. Cada cliente consomeo serviço de acordo com a sua necessidade. PC, Mobile, Integrações...
- 62.
- 63.
- 64. Todo serviço GraphQL provê anavegação por todo o SCHEMA
- 65. A API jánasce documentada
- 66. { __type(name: "News") { name fields{ name } } } { "data": { "__type": { "name": "News", "fields": [ { "name": "id" }, { "name": "user" }, { "name": "media" }, { "name": "title" } //... ] } } }
- 67.
- 68.
- 69.
- 70.
- 71.
- 72. Talk is cheap. Showme the code!
- 73.
- 74.
- 75.