Building my first GraphQL server in PHP

PHP User Group Milan
https://www.meetup.com/MilanoPHP/events/262097221/

Transcript

1. Building my first GraphQL Building my first GraphQL server in PHP server in PHP @davidefedrigo
2. About me About me Software Developer
3. About me About me Software Developer 2017 Started working with GraphQL 2017 Started working with GraphQL
4. About me About me Software Developer 2017 Started working with GraphQL 2017 Started working with GraphQL 2019 Still in love with it! 2019 Still in love with it!
5. About me About me Software Developer 2017 Started working with GraphQL 2017 Started working with GraphQL 2019 Still in love with it! 2019 Still in love with it! linkedin.com/in/davidefedrigo
6. Agenda Agenda Meet GraphQL From theory to practice PHP libraries Additional topics
7. Disclaimer Disclaimer Never done it before! (using PHP)
8. GraphQL has been released GraphQL has been released only as a specification only as a specification
9. A GraphQL service is created by de ning types and elds on those types type Query { randomMovie: Movie } type Movie { id: Int! title: String! }
10. A GraphQL service is created by de ning types and elds on those types Along with functions for each eld on each type type Query { randomMovie: Movie } type Movie { id: Int! title: String! }
11. GraphQL Query JSON Result { randomMovie { title } } { "data": { "randomMovie": { "title": "Back to the Future" } } }
12. Client-Server Interaction Client-Server Interaction
13. GraphQL Advantages GraphQL Advantages Declarative Data Fetching Strongly Typed Expressiveness
14. GraphQL Disadvantages GraphQL Disadvantages Instrumentation Caching
15. Coding Session Coding Session Minimal Example
16. User Input User Input By using the type system, it can be predetermined whether a GraphQL query is valid or not
17. Field Arguments Field Arguments A way for users to parameterize queries query { movies(year: 1985) { title(language: "it") } } { "data": { "movies": [ { "title": "Ritorno al Futuro" }, { "title": "I Goonies" } ] } }
18. Alias Alias query { movies(year:1985) { italianTitle: title(language: "it") englishTitle: title(language: "en") } } { "data": { "movies": [ { "italianTitle": "Ritorno al Futuro", "englishTitle": "Back to the Future" }, { "italianTitle": "I Goonies", "englishTitle": "The Goonies" } ] } }
19. Providing Field Argument Values Providing Field Argument Values As Document Literals As Document Literals query { movies(year: 1985) { title(language: "it") } }
20. Providing Field Argument Values Providing Field Argument Values As Variables As Variables query ($year: Int, $language: String) { movies(year: $year) { title(language: $language) } } { "year": 1985, "language": "it" }
21. Using Enumeration Types Using Enumeration Types A GraphQL enum is a special type of scalar that has a de ned, nite set of possible values. query ($language: Language) { movies { title(language: $language) } } { "language": "IT" }
22. User Input Validation User Input Validation query { actors(matching: 1) { name } } { "errors": [ { "message": "Field \"actors\" argument \"matching\" requires type String!, found 1.", "extensions": { "category": "graphql" }, "locations": [ { "line": 2, "column": 20 } ] } ] }
23. Coding Session Coding Session User Input Examples
24. Abstract Types Abstract Types
25. type Query { searchMovies(matching: String!): [ Movie! ]! searchTVSeries(matching: String!): [ TVSeries! ]! }
26. type Query { searchMovies(matching: String!): [ Movie! ]! searchTVSeries(matching: String!): [ TVSeries! ]! } query { searchMovies(matching: "game") { title runningTime } searchTVSeries(matching: "game") { title seasons { episodes { runningTime } } } }
27. Union Types Union Types A GraphQL union type is an abstract type that represents a set of speci c concrete types
28. Union Types Union Types type Query { searchMovies(matching: String!): [ Movie! ]! searchTVSeries(matching: String!): [ TvSeries! ]! } type Query { search(matching: String!): [ SearchResult! ]! } union SearchResult = Movie | TvSeries
29. query { search(matching: "game") { ... on Movie { title runningTime } ... on TvSeries { title seasons { episodes { runningTime } } } } }
30. { "data": { "search": [ { "title": "Avengers: Endgame", "runningTime": 181 }, { "title": "Game of Thrones", "seasons": [ { "episodes": [ { "runningTime": 62 }, { "runningTime": 56 } ] } ] } ] } }
31. Interfaces Interfaces An Interface is an abstract type that includes a certain set of elds that a type must include to implement the interface
32. Interfaces Interfaces interface BasicSearchResult { title: String! } type Movie implements BasicSearchResult { title: String! runningTime: Int } type TvSeries implements BasicSearchResult { title: String! seasons: [Season!]! }
33. query { search(matching: "game") { title } } } { "data": { "search": [ { "title": "Avengers: Endgame" }, { "title": "Game of Thrones" } ] } }
34. Coding Session Coding Session Abstract Types Examples
35. Operations Operations
36. Mutations Mutations type Mutation { rateMovie(movieId: Int!, stars: Int!, comment: String): MovieReview } type MovieReview { movie: Movie! stars: Int! comment: String }
37. Modeling Input Objects Modeling Input Objects type Mutation { rateMovie(movieId: Int!, review: ReviewInput!): MovieReview } input ReviewInput { stars: Int! comment: String }
38. mutation($movieId: Int!, $review: ReviewInput!) { rateMovie(movieId: $movieId, review: $review) { movie { title stars } stars } } {"movieId": 1, "review": {"stars": 5, "comment": "Awesome!"}} { "data": { "rateMovie": { "movie": { "title": "Avengers: Endgame", "stars": 4.2 }, "stars": 5, "comment": "Awesome!" } } }
39. Modeling Input Objects Modeling Input Objects type Mutation { rateMovie(movieId: Int!, review: ReviewInput!): Review rateTVSeries(tvSeriesId: Int!, review: ReviewInput!): Review } union Review = MovieReview | TvSeriesReview
40. Modeling Input Objects Modeling Input Objects type Mutation { rate(id: Int!, showType: Show!, review: ReviewInput!): Review } enum Show { MOVIE TVSERIES DOCUMENTARY }
41. PHP Libraries PHP Libraries
42. webonyx/graphql-php webonyx/graphql-php (3175 github stars, 68 contributors) Symfony: overblog/GraphQLBundle Laravel: rebing/graphql-laravel API Platform relies on it.
43. youshido-php/GraphQL youshido-php/GraphQL (698 github stars, 34 contributors) Symfony: youshido-php/GraphQLBundle Looking for Maintainers!
44. digiaonline/graphql-php digiaonline/graphql-php (190 github stars, 9 contributors)
45. lighthouse-php.com lighthouse-php.com (1031 github stars, 59 contributors) Lighthouse is a PHP package that allows you to serve a GraphQL endpoint from your Laravel application
46. GraphQL Clients GraphQL Clients
47. GraphiQL GraphiQL
48. GraphQL Playground GraphQL Playground GraphQL Playground is a graphical, interactive, in- browser GraphQL IDE. Integrated with Apollo Server.
49. Insomnia Insomnia
50. Postman Postman
51. Additional Interesting Topics Additional Interesting Topics
52. Additional Interesting Topics Additional Interesting Topics Errors and exceptions
53. Additional Interesting Topics Additional Interesting Topics Errors and exceptions Keep resolvers and domain logic separated
54. Additional Interesting Topics Additional Interesting Topics Errors and exceptions Keep resolvers and domain logic separated N+1 problem
55. Additional Interesting Topics Additional Interesting Topics Errors and exceptions Keep resolvers and domain logic separated N+1 problem Authentication
56. Additional Interesting Topics Additional Interesting Topics Errors and exceptions Keep resolvers and domain logic separated N+1 problem Authentication Testing
57. Additional Interesting Topics Additional Interesting Topics Errors and exceptions Keep resolvers and domain logic separated N+1 problem Authentication Testing Custom Scalar Types
58. Questions? Questions?
59. Thank you! Thank you! github.com/davidefedrigo/graphql-pug