Использование 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 и размещена в рубрике Программирование. Вы можете перейти в конец страницы и оставить ваш комментарий.

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

Вычисление заголовка столбца в Excel

Март 23, 2023 г.

Leetcode задача #168. Excel Sheet column title.Задача помечена как простая, тем не менее, не сразу понял как её решать. Дано число, это номер столбца для Excel таблицы, требуется сгенерировать его буквенное имя. Иными словами сопоставить 1 -> A, ...

Читать

Добавляем свой фильтр в TWIG на Drupal

Июнь 1, 2023 г.

В TWIG уже много разных встроенных фильтров, Drupal их перечень только расширяет. Но наше счастье было бы не полным, если бы мы не могли добавить свои фильтры. В Drupal это делается через сервис twig.extension. Для начала надо сформировать описатель, ...

Читать

Как добавить поддержку thumbnail в кастомный тип публикации

Август 16, 2020 г.

У базовых записей WP есть поддержка поля миниатюры, т.н. прикрепленное изображение. Рассмотрим как добавить поле миниатюры в редактор произвольного типа публикации (custom post type). А в конце статьи - пример вставки миниатюры в шаблон вашей публикации. ...

Читать

Используем PAT для работы с github

Август 19, 2021 г.

GitGub отключили парольную авторизацию, и предлагают использовать SSH с PAT. О том как это настроить и использовать читайте далее в статье. Сложно избавиться о раздражения, когда требуется что то опять настраивать для выполнения ежедневных рутинных ...

Читать

Комментарии к «Использование 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)))
    спасибо большое.

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