Need help with facebook-php-sdk?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

3.3K Stars 3.0K Forks 245 Commits 2 Opened issues


This SDK is deprecated. Find the new SDK here:

Services available


Need anything else?

Contributors list

New SDK Released

We've released version 4 of the Facebook SDK for PHP here: Please use the new repository for new projects and contributions. See the Facebook Developers site for documentation.

Facebook PHP SDK (v.3.2.3) (DEPRECATED)

The Facebook Platform is a set of APIs that make your app more social.

This repository contains the open source PHP SDK that allows you to access Facebook Platform from your PHP app. Except as otherwise noted, the Facebook PHP SDK is licensed under the Apache Licence, Version 2.0 (


The examples are a good place to start. The minimal you'll need to have is: ```php require 'facebook-php-sdk/src/facebook.php';

$facebook = new Facebook(array( 'appId' => 'YOURAPPID', 'secret' => 'YOURAPPSECRET', ));

// Get User ID $user = $facebook->getUser(); ```

To make API calls:

if ($user) {
  try {
    // Proceed knowing you have a logged in user who's authenticated.
    $user_profile = $facebook->api('/me');
  } catch (FacebookApiException $e) {
    $user = null;

You can make api calls by choosing the

HTTP method
and setting optional
$facebook->api('/me/feed/', 'post', array(
    'message' => 'I want to display this message on my wall'

Login or logout url will be needed depending on current user state.

if ($user) {
  $logoutUrl = $facebook->getLogoutUrl();
} else {
  $loginUrl = $facebook->getLoginUrl();

With Composer:

  • Add the
    "facebook/php-sdk": "@stable"
    into the
    section of your
  • Run
    composer install
  • The example will look like
if (($loader = require_once __DIR__ . '/vendor/autoload.php') == null)  {
  die('Vendor directory not found, Please run composer install.');

$facebook = new Facebook(array( 'appId' => 'YOUR_APP_ID', 'secret' => 'YOUR_APP_SECRET', ));

// Get User ID $user = $facebook->getUser();


In order to keep us nimble and allow us to bring you new functionality, without compromising on stability, we have ensured full test coverage of the SDK. We are including this in the open source repository to assure you of our commitment to quality, but also with the hopes that you will contribute back to help keep it stable. The easiest way to do so is to file bugs and include a test case.

The tests can be executed by using this command from the base directory:

phpunit --stderr --bootstrap tests/bootstrap.php tests/tests.php


For us to accept contributions you will have to first have signed the Contributor License Agreement.

When commiting, keep all lines to less than 80 characters, and try to follow the existing style.

Before creating a pull request, squash your commits into a single commit.

Add the comments where needed, and provide ample explanation in the commit message.

Report Issues/Bugs



We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.