subtech/php-sdk-v4

Subtech Facebook SDK for PHP

5.4.4 2017-01-19 15:42 UTC

Requires

• php: ^5.4|^7.0

Requires (Dev)

• guzzlehttp/guzzle: ~5.0
• mockery/mockery: ~0.8
• phpunit/phpunit: ~4.0

Suggests

• guzzlehttp/guzzle: Allows for implementation of the Guzzle HTTP client
• paragonie/random_compat: Provides a better CSPRNG option in PHP 5

Facebook Platform

• Facebook

• facebook
• sdk

README

For Subtech Use on 5.3 PHP Servers

$ composer require subtech/php-sdk-v4 dev-4.1-dev

Installation

The Facebook PHP SDK can be installed with Composer. Add the Facebook PHP SDK package to your composer.json file.

{
    "require": {
        "subtech/php-sdk-v4": "dev-4.1-dev"
    }
}

Usage

Note: This version of the Facebook SDK for PHP requires PHP 5.4 or greater.

Simple GET example of a user's profile.

$fb = new FacebookSubtech\Facebook([
  'app_id' => '{app-id}',
  'app_secret' => '{app-secret}',
  'default_graph_version' => 'v2.2',
  //'default_access_token' => '{access-token}', // optional
]);

// Use one of the helper classes to get a FacebookSubtech\Authentication\AccessToken entity.
//   $helper = $fb->getRedirectLoginHelper();
//   $helper = $fb->getJavaScriptHelper();
//   $helper = $fb->getCanvasHelper();
//   $helper = $fb->getPageTabHelper();

try {
  // Get the FacebookSubtech\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(FacebookSubtech\Exceptions\FacebookResponseException $e) {
  // When Graph returns an error
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookSubtech\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 at: https://developers.facebook.com/docs/php

Tests

1. Composer is a prerequisite for running the tests. Install composer globally, then run composer install to install required files.
2. Create a test app on Facebook Developers, then create tests/FacebookTestCredentials.php from tests/FacebookTestCredentials.php.dist and edit it to add your credentials.
3. 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