nickdnk / graph-sdk
Facebook SDK for PHP compatible with PHP8
Installs: 1 242 879
Dependents: 8
Suggesters: 0
Security: 0
Stars: 37
Watchers: 2
Forks: 13
Open Issues: 0
Requires
- php: ^7.3 || ^8.0
Requires (Dev)
- guzzlehttp/guzzle: ^6.5.0 | ^7.5.0
- mockery/mockery: ~1.5.1
- phpunit/phpunit: ~9.5
Conflicts
- guzzlehttp/guzzle: <6.0
Replaces
- facebook/graph-sdk: >=5.7.0
README
This is an unofficial version of Facebook's PHP SDK designed for PHP 7/8+. It is being maintained and tested against the newest PHP versions. You can use this in place of version 5.x
of Facebook's deprecated facebook/graph-sdk
package.
PHP 7.3 is required.
This repository contains the open source PHP SDK that allows you to access the Facebook Platform from your PHP app.
Installation
The Facebook PHP SDK can be installed with Composer. Run this command:
composer require nickdnk/graph-sdk
By default, the request will be made via a Facebook\HttpClients\FacebookHttpClientInterface
. The default
implementation depends on the available PHP extension/packages. In order of priority:
- Package
guzzlehttp/guzzle
(version 6 or 7):Facebook\HttpClients\FacebookGuzzleHttpClient
- ext-curl:
Facebook\HttpClients\FacebookCurlHttpClient
- Fallback:
Facebook\HttpClients\FacebookStreamHttpClient
Usage
Simple GET example of a user's profile.
require_once __DIR__ . '/vendor/autoload.php'; // change path as needed $fb = new \Facebook\Facebook([ 'app_id' => '{app-id}', 'app_secret' => '{app-secret}', 'default_graph_version' => 'v2.10', //'default_access_token' => '{access-token}', // optional ]); // Use one of the helper classes to get a Facebook\Authentication\AccessToken entity. // $helper = $fb->getRedirectLoginHelper(); // $helper = $fb->getJavaScriptHelper(); // $helper = $fb->getCanvasHelper(); // $helper = $fb->getPageTabHelper(); try { // Get the \Facebook\GraphNodes\GraphUser object for the current user. // If you provided a 'default_access_token', the '{access-token}' is optional. $response = $fb->get('/me', '{access-token}'); } catch(\Facebook\Exceptions\FacebookResponseException $e) { // When Graph returns an error echo 'Graph returned an error: ' . $e->getMessage(); exit; } catch(\Facebook\Exceptions\FacebookSDKException $e) { // When validation fails or other local issues echo 'Facebook SDK returned an error: ' . $e->getMessage(); exit; } $me = $response->getGraphUser(); echo 'Logged in as ' . $me->getName();
Complete documentation, installation instructions, and examples are available here.
Tests
- Composer is a prerequisite for running the tests. Install composer globally, then
run
composer install
to install required files. - Create a test app on Facebook Developers, then
create
tests/FacebookTestCredentials.php
fromtests/FacebookTestCredentials.php.dist
and edit it to add your credentials. - The tests can be executed by running this command from the root directory:
$ ./vendor/bin/phpunit
By default, the tests will send live HTTP requests to the Graph API. If you are without an internet connection you can
skip these tests by excluding the integration
group.
$ ./vendor/bin/phpunit --exclude-group integration
License
Please see the license file for more information.