面条智者/facebook-php-sdk-v4

Laravel Facebook SDK for PHP

5.1.0 2015-10-13 22:11 UTC

README

Build Status Scrutinizer Code Quality Latest Stable Version

一个简单的Facebook SDK,用于Laravel的会话处理

该仓库包含开源PHP SDK,允许您从PHP应用程序访问Facebook平台。

安装

可以使用Composer安装Facebook PHP SDK。运行以下命令

composer require facebook/php-sdk-v4

升级到v5.x

从v4.x升级?Facebook PHP SDK v5.x引入了破坏性更改。在升级之前,请阅读升级指南

用法

注意:此版本的Facebook SDK for PHP需要PHP 5.4或更高版本。

一个用户资料的简单GET示例。

$fb = new Facebook\Facebook([
  'app_id' => '{app-id}',
  'app_secret' => '{app-secret}',
  'default_graph_version' => 'v2.5',
  //'default_access_token' => '{access-token}', // optional
]);

// Use one of the helper classes to get a Facebook\Authentication\AccessToken entity.
//   $helper = $fb->getRedirectLoginHelper();
//   $helper = $fb->getJavaScriptHelper();
//   $helper = $fb->getCanvasHelper();
//   $helper = $fb->getPageTabHelper();

try {
  // Get the Facebook\GraphNodes\GraphUser object for the current user.
  // If you provided a 'default_access_token', the '{access-token}' is optional.
  $response = $fb->get('/me', '{access-token}');
} 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;
}

$me = $response->getGraphUser();
echo 'Logged in as ' . $me->getName();

完整的文档、安装说明和示例可在以下网址找到:https://developers.facebook.com/docs/php

测试

  1. 运行测试需要Composer。全局安装composer,然后运行composer install安装所需的文件。
  2. Facebook Developers上创建一个测试应用,然后从tests/FacebookTestCredentials.php.dist创建tests/FacebookTestCredentials.php并编辑它以添加您的凭据。
  3. 您可以从根目录运行以下命令来执行测试
$ ./vendor/bin/phpunit

默认情况下,测试将通过Graph API发送实时HTTP请求。如果您没有互联网连接,可以排除integration组以跳过这些测试。

$ ./vendor/bin/phpunit --exclude-group integration

贡献

为了接受贡献,您必须首先签署贡献者许可协议。请参阅CONTRIBUTING以获取详细信息。

许可证

请参阅许可证文件以获取更多信息。