FACEBOOK PHP SDK V4 THE NEW GRAPH API AND WHY YOU'RE GONNA HAVE TO REWRITE all the things 

HI! I'M @SAMMYK 

HISTORY OF GRAPH 

New IN GRAPH 

VERSIONING! HTTPS://GRAPH.FACEBOOK.COM/V2.0/ 

APP-SCOPED USER ID'S 

BETTER PERMISSION MANAGEMENT 

NEW GRAPH edges ▸ /user/taggable_friends ▸ /user/invitable_friends ▸ /user/idsforbusiness 

MORE NEW STUFFS ▸ 48-hour bug fix commitment ▸ Test apps ▸ New review process for extended permissions ▸ Loads more 

THE OLD SDK ...AND WHAT sucked ABOUT IT 

FULL OF bugs 

IMPOSSIBLE TO extend 

COMMITMENT TO Open Source HTTPS://CODE.FACEBOOK.COM/ 

SDK v3 WAS ...FACEBOOK'S RED-HEADED STEP CHILD 

WRITE YOUR OWN SDK, DARNET! 

FOSCO TO THE RESCUE! 

THE NEW SDK v4 THE GOOD, THE BAD, AND THE ANNOYING 

THE GOOD 

COMPOSER SUPPORT ...AND PSR-4 AUTOLOADING 

{ "require" : { "facebook/php-sdk-v4" : "4.0.*" } } 

OBJECT-ORIENTED ...BUT NOT A STELLAR ARCHITECTED DESIGN 

IT'S NAMESPACED UNDER THE \Facebook NAMESPACE 

IT'S mostly UNIT TESTED 

FOSCO IS awesome SEEMS TO BE FIGHTING FOR US 

THE BAD IT AINT ALL DANDELIONS AND RAINBOWS 

THE API Kinda Sucks 

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()); 

FacebookSession IS A HORRIBLE NAME FOR WHAT IT ACTUALLY DOES 

Extensibility ISN'T FUN IT'S DONE WITH SUPPER-CLASS EXTENSION 

...WHICH SUCKS WHEN THE DEV MANAGES all the things 

UNIT TESTS AREN'T IN ISOLATION & MIXED WITH FUNCTIONAL TESTS 

ENOUGH complaining LET'S DIVE INTO THE CODE! 

GETTING AN Access Token 

HELPERS GET THE ACCESS TOKEN ▸ FacebookRedirectLoginHelper ...for your website ▸ FacebookCanvasLoginHelper ..for canvas apps ▸ FacebookJavaScriptLoginHelper ..cookies from Javascript SDK 

use Facebook\FacebookRedirectLoginHelper; $helper = new FacebookRedirectLoginHelper($redirect_url); $login_url = $helper->getLoginUrl(); 

$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. } 

BEWARE! OF storeState() AND loadState() 

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; } 

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. 

$helper->disableSessionStatusCheck(); 

Poking GRAPH GET IT? ...ANYONE? ...ANYONE? 

YOU'LL NEED TWO OBJECTS TO DO IT ▸ FacebookSession the access-token object ▸ FacebookRequest handles requests made to Graph 

$session = new FacebookSession('access-token-here'); $request = new FacebookRequest( $session, 'GET', '/some-object-id?fields=id,name' ); $something = $request->execute()->getGraphObject(); 

FacebookRequest() RETURNS FacebookResponse() 

FacebookResponse() CAN GET A GraphObject() 

$some_graph_object = $request->execute()->getGraphObject(); 

IT'S A "GETTER OBJECT" getProperty('some_field') 

GraphObject()'S CAN BE CAST TO SUB OBJECTS 

SUB GraphObject'S ▸ GraphUser casts a DateTime() ▸ GraphLocation ▸ GraphSessionInfo casts some DateTime()'s ▸ new: GraphAlbum casts some DateTime()'s 

WTF!? SO REDUNDANT & ANNOYING TO USE A BUNCH OF GETTERS 

DIGGING DEEPER GETTING A CRAP-TON OF DATA FROM GRAPH 

GET A USER'S NAME & 5 photos 

THERE'S A MUCH BETTER WAY WITH Field Expansion A.K.A "NESTED REQUESTS" 

/{node-id}?fields={first-level}.fields({second-level}) 

/me?fields=name,photos.limit(5) 

$request = new FacebookRequest( $session, 'GET', '/me?fields=name,photos.limit(5)' ); $something = $request->execute()->getGraphObject(); 

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 

/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)) 

$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(); 

THERE must BE A BETTER WAY! THERE IS. ENTER FACEBOOK QUERY BUILDER HTTPS://GITHUB.COM/SAMMYK/FACEBOOKQUERYBUILDER 

$user = $fqb->object('me')->get(); 

{ "require": { "sammyk/facebook-query-builder": "1.0.*" } } 

use SammyK\FacebookQueryBuilder\FQB; FQB::setAppCredentials('your_app_id', 'your_app_secret'); FQB::setAccessToken('access_token'); $fqb = new FQB(); 

// 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(); 

$event_photos = $fqb ->edge('photos') ->fields('name', 'source') ->limit(2); 

END @SAMMYK