Facebook PHP SDK v4 & the new Graph API

...and why you're gonna have to rewrite all the things.
Open Spaces talk @ php[tek] on May 22, 2014.

Transcript

1. FACEBOOK PHP SDK V4 THE NEW GRAPH API AND WHY YOU'RE GONNA HAVE TO REWRITE all the things
2. HI! I'M @SAMMYK
3. HISTORY OF GRAPH
4. New IN GRAPH
5. VERSIONING! HTTPS://GRAPH.FACEBOOK.COM/V2.0/
6. APP-SCOPED USER ID'S
7. BETTER PERMISSION MANAGEMENT
8. NEW GRAPH edges ▸ /user/taggable_friends ▸ /user/invitable_friends ▸ /user/idsforbusiness
9. MORE NEW STUFFS ▸ 48-hour bug fix commitment ▸ Test apps ▸ New review process for extended permissions ▸ Loads more
10. THE OLD SDK ...AND WHAT sucked ABOUT IT
11. FULL OF bugs
12. IMPOSSIBLE TO extend
13. COMMITMENT TO Open Source HTTPS://CODE.FACEBOOK.COM/
14. SDK v3 WAS ...FACEBOOK'S RED-HEADED STEP CHILD
15. WRITE YOUR OWN SDK, DARNET!
16. FOSCO TO THE RESCUE!
17. THE NEW SDK v4 THE GOOD, THE BAD, AND THE ANNOYING
18. THE GOOD
19. COMPOSER SUPPORT ...AND PSR-4 AUTOLOADING
20. { "require" : { "facebook/php-sdk-v4" : "4.0.*" } }
21. OBJECT-ORIENTED ...BUT NOT A STELLAR ARCHITECTED DESIGN
22. IT'S NAMESPACED UNDER THE \Facebook NAMESPACE
23. IT'S mostly UNIT TESTED
24. FOSCO IS awesome SEEMS TO BE FIGHTING FOR US
25. THE BAD IT AINT ALL DANDELIONS AND RAINBOWS
26. THE API Kinda Sucks
27. use Facebook\FacebookSession; use Facebook\FacebookRequest; use Facebook\GraphUser; $session = new FacebookSession('access-token-here'); $user = (new FacebookRequest( $session, 'GET', '/me?fields=id,name' ))->execute()->getGraphObject(GraphUser::className());
28. FacebookSession IS A HORRIBLE NAME FOR WHAT IT ACTUALLY DOES
29. Extensibility ISN'T FUN IT'S DONE WITH SUPPER-CLASS EXTENSION
30. ...WHICH SUCKS WHEN THE DEV MANAGES all the things
31. UNIT TESTS AREN'T IN ISOLATION & MIXED WITH FUNCTIONAL TESTS
32. ENOUGH complaining LET'S DIVE INTO THE CODE!
33. GETTING AN Access Token
34. HELPERS GET THE ACCESS TOKEN ▸ FacebookRedirectLoginHelper ...for your website ▸ FacebookCanvasLoginHelper ..for canvas apps ▸ FacebookJavaScriptLoginHelper ..cookies from Javascript SDK
35. use Facebook\FacebookRedirectLoginHelper; $helper = new FacebookRedirectLoginHelper($redirect_url); $login_url = $helper->getLoginUrl();
36. $helper = new FacebookRedirectLoginHelper($redirect_url); try { $session = $helper->getSessionFromRedirect(); } catch(FacebookRequestException $ex) { // When Facebook returns an error } catch(\Exception $ex) { // When validation fails or other local issues } if ($session) { // Logged in. }
37. BEWARE! OF storeState() AND loadState()
38. protected function loadState() { if ($this->checkForSessionStatus === true && session_status() !== PHP_SESSION_ACTIVE) { throw new FacebookSDKException( 'Session not active, could not load state.', 721 ); } if (isset($_SESSION[$this->sessionPrefix . 'state'])) { $this->state = $_SESSION[$this->sessionPrefix . 'state']; return $this->state; } return null; }
39. session_status() ▸ PHP_SESSION_DISABLED if sessions are disabled. ▸ PHP_SESSION_NONE if sessions are enabled, but none exists. ▸ PHP_SESSION_ACTIVE if sessions are enabled, & one exists.
40. $helper->disableSessionStatusCheck();
41. Poking GRAPH GET IT? ...ANYONE? ...ANYONE?
42. YOU'LL NEED TWO OBJECTS TO DO IT ▸ FacebookSession the access-token object ▸ FacebookRequest handles requests made to Graph
43. $session = new FacebookSession('access-token-here'); $request = new FacebookRequest( $session, 'GET', '/some-object-id?fields=id,name' ); $something = $request->execute()->getGraphObject();
44. FacebookRequest() RETURNS FacebookResponse()
45. FacebookResponse() CAN GET A GraphObject()
46. $some_graph_object = $request->execute()->getGraphObject();
47. IT'S A "GETTER OBJECT" getProperty('some_field')
48. GraphObject()'S CAN BE CAST TO SUB OBJECTS
49. SUB GraphObject'S ▸ GraphUser casts a DateTime() ▸ GraphLocation ▸ GraphSessionInfo casts some DateTime()'s ▸ new: GraphAlbum casts some DateTime()'s
50. WTF!? SO REDUNDANT & ANNOYING TO USE A BUNCH OF GETTERS
51. DIGGING DEEPER GETTING A CRAP-TON OF DATA FROM GRAPH
52. GET A USER'S NAME & 5 photos
53. THERE'S A MUCH BETTER WAY WITH Field Expansion A.K.A "NESTED REQUESTS"
54. /{node-id}?fields={first-level}.fields({second-level})
55. /me?fields=name,photos.limit(5)
56. $request = new FacebookRequest( $session, 'GET', '/me?fields=name,photos.limit(5)' ); $something = $request->execute()->getGraphObject();
57. GIVE ME all the things! ▸ User's Name ▸ Last profile update time ▸ The first 4 events that the user is attending & first 2 photos from each event ▸ The first 3 pages the user likes ▸ The first 5 photos the user is tagged in
58. /me?fields=name,updated_time,photos.limit(5).fields(name,source), likes.limit(3).fields(name,link), events.limit(4).fields(name,start_time,end_time, photos.limit(2).fields(name,source))
59. $request = new FacebookRequest( $session, 'GET', '/me?fields=name,updated_time,photos.limit(5).fields(name,source), likes.limit(3).fields(name,link), events.limit(4).fields(name,start_time,end_time, photos.limit(2).fields(name,source))' ); $something = $request->execute()->getGraphObject();
60. THERE must BE A BETTER WAY! THERE IS. ENTER FACEBOOK QUERY BUILDER HTTPS://GITHUB.COM/SAMMYK/FACEBOOKQUERYBUILDER
61. $user = $fqb->object('me')->get();
62. { "require": { "sammyk/facebook-query-builder": "1.0.*" } }
63. use SammyK\FacebookQueryBuilder\FQB; FQB::setAppCredentials('your_app_id', 'your_app_secret'); FQB::setAccessToken('access_token'); $fqb = new FQB();
64. // Get first 5 photos the user is tagged in $photos_user_tagged_in = $fqb ->edge('photos') ->fields('name', 'source') ->limit(5); // Get first 3 pages this user likes $pages_user_likes = $fqb ->edge('likes') ->fields('name', 'link') ->limit(3); // Get first 4 events that this user is attending // And first 2 photos from each event $event_photos = $fqb ->edge('photos') ->fields('name', 'source') ->limit(2); $events_user_attending = $fqb ->edge('events') ->fields('name', 'start_time', 'end_time', $event_photos) ->limit(4); // Get the logged in user's name, last profile update time, and all those edges $user_data = $fqb->object('me') ->fields('name', 'updated_time', $photos_user_tagged_in, $pages_user_likes, $events_user_attending); ->get();
65. $event_photos = $fqb ->edge('photos') ->fields('name', 'source') ->limit(2);
66. END @SAMMYK