README

该仓库包含了一个开源PHP SDK，允许您从PHP应用程序中访问Facebook平台。

安装

Facebook PHP SDK可以通过 Composer 安装。运行以下命令

composer require rusakovvv/php-graph-sdk

请注意，当与 Guzzle 6.x 一起使用时，可能会出现问题。php-graph-sdk v5.x 仅与 Guzzle 5.x 兼容。然而，存在一种解决方案，使其与Guzzle 6.x 兼容。

使用方法

注意：此版本的Facebook SDK需要PHP 8或更高版本。

用户资料的简单GET示例。

require_once __DIR__ . '/vendor/autoload.php'; // change path as needed

$fb = new \Facebook\Facebook([
  'app_id' => '{app-id}',
  'app_secret' => '{app-secret}',
  'default_graph_version' => 'v2.10',
  //'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();

测试

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。

许可

有关更多信息，请参阅许可文件。

安全漏洞

如果您发现了一个安全问题，请直接联系维护者 me@sammyk.me。