Headless Drupal 8. #HeadlessDrupal

Transcription

1 Headless Drupal 8 #HeadlessDrupal

2 Ruben

3

4

5

6

7

8 A little bit of history

9 Drupal 7 Front-end Sucks!

10 DIVITIS

11

12 Contrib Helps

13

14 "The front-end moves faster than Drupal, whether Drupal likes it or

15

16 Mobile Web/Apps

17 Browserless Devices

18 Internet of Things

19 Drupal8

20 Loosely Coupled Architecture

21 Drupal 8 Front-end Certified

22 I love Twig!! WTF!!

23 Big Pipe

24 Accessibility

25 Translations

26 Security

27 Solution

28 Monolithic Application

29 Microservices

30 Decoupling

31 Fully Decoupled Vs Progressively Decoupled

32 Headless Drupal The Cake is a

33 @thefubhy No, I don't have a better profile picture

34 Headless Drupal 8

35 We don't need contrib anymoar!!

36 Headless Drupal 8 REST modules are in Core

37 Don't forget the permissions

38 CRUD Create Read Update Delete

39 Sample Create Request curl --include --request POST --user user:password --header 'Content-type: application/hal+json' --data-binary '{"_links":{"type": {"href":" e/page"}}, "title":[{"value":"node created using curl"}], "body": [{"value":"this is the body of the node created using curl"}]}'

40 Sample Create Response HTTP/ Created Date: Fri, 24 Oct :26:50 GMT Server: Apache/ (Debian) X-Powered-By: PHP/ ~dotdeb.1 Location:

41 CRUD Create Read Update Delete

42 Sample Read Request curl -H "Accept:application/hal+json" --request GET _format=hal_json

43 Sample Read Response {"_links":{"self":{"href":" {"href":" host\/drupal8\/rest\/relation\/node\/page\/uid": [{"href":" ost\/drupal8\/rest\/relation\/node\/page\/revision_uid": [{"href":" [{"value":"en"}],"title":[{"value":"node updated using curl","lang":"en"}],"_embedded": {" {"self":{"href":" {"href":" [{"value":"b3e6e828-03fa-4a19-a7066bba6f47edc4"}],"lang":"en"}]," de\/page\/revision_uid":[{"_links":{"self": {"href":" {"href":" [{"value":"b3e6e828-03fa-4a19-a706-6bba6f47edc4"}]}]},"status": [{"value":"1","lang":"en"}],"created": [{"value":" ","lang":"en"}],"changed": [{"value":" ","lang":"en"}],"promote": [{"value":"0","lang":"en"}],"sticky": [{"value":"0","lang":"en"}],"revision_timestamp": [{"value":" "}],"body":[{"value":"this is the body of the node updated using curl","format":null,"summary":null,"lang":"en"}]}

44 CRUD Create Read Update Delete

45 Sample Update Request curl --include --request PATCH --user user:password --header 'Content-type: application/hal+json' --data-binary '{"_links":{"type": {"href":" e/page"}}, "title":[{"value":"node updated using curl"}], "body": [{"value":"this is the body of the node updated using curl"}]}'

46 Sample Update Response HTTP/ No Content Date: Fri, 24 Oct :43:53 GMT Server: Apache/ (Debian) X-Powered-By: PHP/ ~dotdeb.1

47 CRUD Create Read Update Delete

48 Sample Delete Request curl --include --request DELETE --user user:password --header 'Content-type: application/hal+json'

49 Sample Delete Response HTTP/ No Content Date: Fri, 24 Oct :51:04 GMT Server: Apache/ (Debian) X-Powered-By: PHP/ ~dotdeb.1

50 Views are in Core too!!

51

52 for

53 REST export

54 REST export settings

55 Sample Request curl -H "Accept:application/hal+json" --request GET

56 Sample Response [{"_links":{"self":{"href":" {"href":" \/rest\/relation\/node\/article\/uid": [{"href":" st\/relation\/node\/article\/revision_uid": [{"href":" [{"value":"you don't get sick, I do","lang":"en"}],"_embedded": {" {"href":" {"href":" ision_uid":[{"_links":{"self":{"href":" {"href":" [{"value":" ","lang":"en"}],"changed":[{"value":" ","lang":"en"}],"promote": [{"value":"1","lang":"en"}],"sticky":[{"value":"0","lang":"en"}],"revision_timestamp": [{"value":" "}],"revision_log":[{"value":"","lang":"en"}],"body":[{"value":"<p>your bones don't break, mine do. That's clear. Your cells react to bacteria and viruses differently than mine. You don't get sick, I do. That's also clear. But for some reason, you and I react the exact same way to water. We swallow it too fast, we choke. We get some in our lungs, we drown. However unreal it may seem, we are connected, you and I. We're on the same curve, just on opposite ends.<\/p>\r\n","format":"basic_html","summary":"","lang":"en"}],"comment": [{"status":"2","cid":"0","last_comment_timestamp":" ","last_comment_name":null,"last_ comment_uid":"1","comment_count":"0","lang":"en"}]}]

57 vs HAL JSON

58 Use HAL if you care about API definition { "_links": { "self": { "href": "/your-api-links" } }, "_embedded": { "items": [ Array of serialized items ] } }

59 Use JSON if you only care about the content [ { "title": This is your content title, "body": This is your content body. } ]

60 How to enable JSON requests

61 core/modules/rest/config/install/rest.settings.yml resources: entity:node: GET: supported_formats: - hal_json supported_auth: - basic_auth POST: supported_formats: - hal_json supported_auth: - basic_auth PATCH: supported_formats: - hal_json supported_auth: - basic_auth DELETE: supported_formats: - hal_json supported_auth: - basic_auth

62 Configuration Management Single Import

63

64 Sample JSON Request curl -H "Accept: application/json" --request GET

65 Sample JSON Response [{"nid":[{"value":"1"}],"uuid":[{"value":"5fad49bf-5c70-475d c25caf62d5"}],"vid":[{"value":"1"}],"type": [{"target_id":"article"}],"langcode":[{"value":"en"}],"title": [{"value":"you don't get sick, I do"}],"uid": [{"target_id":"1"}],"status":[{"value":"1"}],"created": [{"value":" "}],"changed":[{"value":" "}],"promote": [{"value":"1"}],"sticky":[{"value":"0"}],"revision_timestamp": [{"value":" "}],"revision_uid": [{"target_id":"1"}],"revision_log":[{"value":""}],"path": [{"alias":null,"pid":null}],"body":[{"value":"<p>your bones don't break, mine do. That's clear. Your cells react to bacteria and viruses differently than mine. You don't get sick, I do. That's also clear. But for some reason, you and I react the exact same way to water. We swallow it too fast, we choke. We get some in our lungs, we drown. However unreal it may seem, we are connected, you and I. We're on the same curve, just on opposite ends.<\/p>\r\n","format":"basic_html","summary":""}],"comment": [{"status":"2","cid":"0","last_comment_timestamp":" ","last_com ment_name":null,"last_comment_uid":"1","comment_count":"0"}],"field_imag e": [{"target_id":null,"display":null,"description":null,"alt":null,"title": null,"width":null,"height":null}],"field_tags":[{"target_id":null}]}]

66 BEWARE!! hal_json is the only format supported for POST and PATCH methods It needs work:

67 Getting a cleaner JSON response

68 Use Fields in View

69 Fields Raw Format

70 Clean JSON Response [ { "title":"you don't get sick, I do", "body":"<p>your bones don't break, mine do. That's clear. Your cells react to bacteria and viruses differently than mine. You don't get sick, I do. That's also clear. But for some reason, you and I react the exact same way to water. We swallow it too fast, we choke. We get some in our lungs, we drown. However unreal it may seem, we are connected, you and I. We're on the same curve, just on opposite ends.<\/p>" } ]

71 Resources

72 Don't miss

73

74

75

76

77

78 Want to contribute? [meta] REST et al How to POST a comment and other relational entities Add special handling for collections in REST Support ConfigEntity via REST File needs CRUD permissions to make REST work on entity/file/{id} Serialize file content (base64) to support REST GET/POST/PATCH on file entity

79 Join the Code Sprints!!

80 ? Questions?

81 Thanks!