Использование Facebook PHP SDK, подключение и настройка

Основная проблема тех, кто начинает работать с Facebook SDK, это наличие предыдущего опыта работы с другими сторонними API и SDK. Просто забудьте все, что знали раньше :). Внутренний мир разработчиков facebook богат и многообразен, потому простых решений вы тут не увидите.

Т.к. очередная версия SDK устаревает в течении 2 лет (точнее гарантированно работает не более 2-х лет с момента релиза), то лучше читать гайд от самого facebook.

Он вот тут — https://developers.facebook.com/docs/php/gettingstarted

Текущая версия — v2.8. Раз вы пришли сюда, то, видимо, стиль документации facebook сидит у вас где то в печенках :).

Модель работы в общих чертах

Чтобы что то получить/передать через API, нужно, чтобы вы представились Facebook. В конечном счете, всё сводится к тому, что вы должны получить «маркер доступа». Это такой временный ключ.

Существуют разные типы маркеров доступа (да, всё не просто):

https://developers.facebook.com/docs/facebook-login/access-tokens

Они отличаются во своим возможностям. Типичный подход — использование маркера доступа приложения (МДП).

Но чтобы получить МДП, нужно сначала зарегистрировать приложение.

На момент написания статьи актуальная версия PHP SKD 5.4. Скачать можно здесь — https://github.com/facebook/facebook-php-sdk-v4/. Если выйдет свежая версия, ориентируетесь на месте. После этого можно приступать к написанию кода.

Далее все этапы подробнее.

Регистрация приложения на Facebook

Не так сложно как звучит. Фактически, мы создаём учетную запись, через которую будет производится доступ к API.

Переходите на https://developers.facebook.com/apps/, жмите по кнопе — «добавить приложение». Заполняйте форму (она выше на скриншоте), и вы попадете в карточку вашего только что созданного приложения.

Здесь нам понадобится значение двух полей: идентификатор приложения (app_id) и ключ-секрет (app secret).

Установка PHP SDK Facebook.

Самая свежая версия работает с PHP v5.4. В архиве куча всякого хлама, нас интересует только библиотеки в папке /src/Facebook/.

Создадим для них, к примеру, папку /fb-sdk в корне вашего сайта. Копируем :)

А PHP добавим следующий код:

//подключили SDK
require_once $_SERVER['DOCUMENT_ROOT'] . '/fb-sdk/autoload.php';
//если не запущены ранее, запускаем сессии
session_start();
//создаём подключение к API через наше приложение
$fb = new Facebook\Facebook([
   'app_id' => '{APP_KEY}', 
   'app_secret' => '{APP_SECRET}',
   'default_graph_version' => 'v2.8',
]);

//подключили SDK

require_once $_SERVER['DOCUMENT_ROOT'] . '/fb-sdk/autoload.php';

//если не запущены ранее, запускаем сессии

session_start();

//создаём подключение к API через наше приложение

$fb = new Facebook\Facebook([

'app_id' => '{APP_KEY}',

'app_secret' => '{APP_SECRET}',

'default_graph_version' => 'v2.8',

]);

В код нужно вставить ваши значения ключа и секрета.

Создание токена доступа приложения (accessToken)

Пришло время создать токен доступа.

В документации продемонстрировано множество способов получения токена из разных контекстов, но все как то «мимо кассы» — то из facebook canvas, то из авторизации пользователя. Надеюсь, этот пример будет более полезным.

Снова пригодится ключ и секрет:

try {
   //получить токен
   $response = $fb->get('/oauth/access_token?client_id={APP_KEY}'
   . '&client_secret={APP_SECRET}&grant_type=client_credentials');
   //парсим ответ сервера
   $resp = $response->getDecodedBody();
   //берем значение токена
   $accessToken = $resp['access_token'];
   //устанавливаем его для использования по-умолчанию:
   $fb->setDefaultAccessToken($accessToken);
} 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;
}

try {

//получить токен

$response = $fb->get('/oauth/access_token?client_id={APP_KEY}'

. '&client_secret={APP_SECRET}&grant_type=client_credentials');

//парсим ответ сервера

$resp = $response->getDecodedBody();

//берем значение токена

$accessToken = $resp['access_token'];

//устанавливаем его для использования по-умолчанию:

$fb->setDefaultAccessToken($accessToken);

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

}

Пример получения данных

В целом, вы готовы уже получить что то из разряда общедоступных данных. Без такого примера, картина была бы не полной.

//если токен получен...
if (isset($accessToken)) {
  try {
    //получим данные о пользователе под номером 1000
    $response = $fb->get('1000?fields=name,first_name,last_name,age_range'
    . ',link,gender,locale,picture,timezone,updated_time,verified');
    $RS = $response->getGraphUser();
    print_r($RS);
  } 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;
  }

} else {
   echo 'Not logged in';
}

//если токен получен...

if (isset($accessToken)) {

try {

//получим данные о пользователе под номером 1000

$response = $fb->get('1000?fields=name,first_name,last_name,age_range'

. ',link,gender,locale,picture,timezone,updated_time,verified');

$RS = $response->getGraphUser();

print_r($RS);

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

}

} else {

echo 'Not logged in';

}

У меня выводит следующую инфу:

Доступные поля объектов — смотрите в документации: https://developers.facebook.com/docs/reference/php в секции reference.

Написать комментарий

Данная запись опубликована в 05.02.2017 22:40 и размещена в рубрике Программирование. Вы можете перейти в конец страницы и оставить ваш комментарий.

Мало букафф? Читайте есчо !

Битые картинки vs CSS

Февраль 6, 2021 г.

Перефразируя устойчивое выражение: broken image happens. И раз уж они все равно могут появиться на вашем сайте, то с ними нужно что то делать, т.е. как ...

Читать

Как получить определения из конфигурационных файлов схем Drupal

Апрель 6, 2025 г.

Drupal config API позволяет не только прочитать сами настройки, но и файлы их определений. В общем то это очевидно, покажу как это делается. Допустим ...

Читать

Кастомные настройки сайта в Drupal

Март 9, 2025 г.

На сайте всегда (или почти всегда) возникает задача управления настройками вроде телефон, email, какие то текстовые элементы, вроде копирайта, адрес организации и т.п. С точки зрения данных - требуется объект в терминах шаблонов проектирования - синглтон. ...

Читать

Включаем сессии в Wordpress

Апрель 17, 2016 г.

В сессиях удобно хранить что то, связанное с текущей деятельностью пользователя. Оказалось, что в Wordpress сессии не запускаются движком. Стартовать их нужно самостоятельно. Впрочем, запуск сессий где то посреди шаблона не прокатит. Нужно подключить ...

Читать

Комментарии к «Использование Facebook PHP SDK, подключение и настройка»

Понравилась статья? Есть вопросы? - пишите в комментариях.

Много комментариев в “Использование Facebook PHP SDK, подключение и настройка”

Job:

25 августа 2017 в 11:23

Здраствуйте, у меня выдает ошибку где

$fb = new Facebook\Facebook([

выдает синтаксическую ошибку на слэш,
как мне можно это исправить?

Ответить
- admin:
  
  25 августа 2017 в 12:47
  
  Версию PHP проверьте, namespace поддерживается с 5.3.
  
  Ответить
  - Job:
    
    25 августа 2017 в 17:57
    
    у меня оказывается 5.2.6)))
    спасибо большое.

Имя (обязательно)	Е-майл (не будет опубликован на сайте, обязательно для заполнения)
Комментарий: