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

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

Как в Drupal 9 получить URL изображения, сохраненного в поле media

Июль 27, 2021 г.

Чтобы извлечь адрес изображения из картинки в поле типа media, требуется ряд преобразований с использованием Entity объектов Drupal. Предполагается, что вы уже загрузили entity с полем типа media (в примере называется - field_media) в какую то ...

Читать

Как убрать инфо о текстовых форматах в комментариях Drupal?

Ноябрь 13, 2016 г.

Речь идет о выводе дополнительной информации в форме комментариев после основного текстового поля - "формат текста". Поле это совершенно не нужно пользователям ...

Читать

Передача параметров при создании viewModel

Февраль 17, 2025 г.

Распространенная задача - при создании viewModel требуется передать параметры из активити или фрагмента. ViewModel используется для хранения состояния данных экрана, отвечая только за т.н. бизнес логику. Жизненный цикл этого компонента не зависит ...

Читать

Многоязычность в Drupal 7

Март 31, 2015 г.

Конструирование многоязычного сайта добавляет множество деталей, которые нужно учитывать в процессе работы. Это и верстка шаблона, картинки которого могут ...

Читать

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

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