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

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

Удаление nodequeue программно

Май 28, 2021 г.

Небольшой сниппет (snippet) по удалению сущностей nodequeue из кода. Может быть полезно при миграции данных. Удобно оперировать с машинным именем нод-кью, но функция удаления требует ID, потому код обычно обретает следующие формы: [crayon-6a9be9f71e94e988908440/] ...

Читать

Добавление своих suggestion в Drupal 9/10

Май 2, 2023 г.

Для добавления suggestions требуется использовать соответствующий группе шаблонов hook. Если название шаблона не известно, то его можно подсмотреть в режиме ...

Читать

Рендер ссылки в twig

Октябрь 3, 2021 г.

В шаблонах twig вы можете использовать функцию link, для рендера ссылки. Параметры вызова следующие - link($text, $uri, $attributes = {}), первые два - обязательные. [crayon-6a9be9f71eb68138231188/] Результатом будет следующий HTML код: ...

Читать

Как полностью удалить поле в Drupal, если оно «зависло» в хранилище полей

Сентябрь 5, 2025 г.

Иногда в Drupal возникает ситуация: вы удаляете поле с типов сущностей (bundle), но оно не исчезает полностью из системы. UI говорит, что поле «используется», хотя на самом деле ни одна сущность его не использует. В этом случае поле остаётся в конфигурации ...

Читать

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

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