README

新 SDK 发布

我们在这里发布了 Facebook SDK for PHP 的第 4 版：[https://github.com/facebook/facebook-php-sdk-v4](https://github.com/facebook/facebook-php-sdk-v4)。请使用新的仓库进行新项目和贡献。请参阅 [Facebook 开发者](https://developers.facebook.com/docs/php/) 网站以获取文档。

Facebook PHP SDK (v.3.2.3) (已弃用)

Facebook 平台 是一套 API，可以让您的应用更具社交性。

此存储库包含允许您从 PHP 应用程序访问 Facebook 平台的开源 PHP SDK。除非另有说明，Facebook PHP SDK 根据 Apache 许可证 2.0 版本授权（[https://apache.ac.cn/licenses/LICENSE-2.0.html](https://apache.ac.cn/licenses/LICENSE-2.0.html)）。

使用方法

示例是一个好起点。您至少需要以下内容

require 'facebook-php-sdk/src/facebook.php';

$facebook = new Facebook(array(
  'appId'  => 'YOUR_APP_ID',
  'secret' => 'YOUR_APP_SECRET',
));

// Get User ID
$user = $facebook->getUser();

进行 API 调用

if ($user) {
  try {
    // Proceed knowing you have a logged in user who's authenticated.
    $user_profile = $facebook->api('/me');
  } catch (FacebookApiException $e) {
    error_log($e);
    $user = null;
  }
}

您可以通过选择 HTTP 方法 并设置可选的 参数 来进行 API 调用

$facebook->api('/me/feed/', 'post', array(
	'message' => 'I want to display this message on my wall'
));

登录或登出 URL 将根据当前用户状态而有所不同。

if ($user) {
  $logoutUrl = $facebook->getLogoutUrl();
} else {
  $loginUrl = $facebook->getLoginUrl();
}

使用 Composer

• 将 "facebook/php-sdk": "@stable" 添加到 composer.json 的 require 部分。
• 运行 composer install。
• 示例将如下所示

if (($loader = require_once __DIR__ . '/vendor/autoload.php') == null)  {
  die('Vendor directory not found, Please run composer install.');
}

$facebook = new Facebook(array(
  'appId'  => 'YOUR_APP_ID',
  'secret' => 'YOUR_APP_SECRET',
));

// Get User ID
$user = $facebook->getUser();

测试

为了保持我们的敏捷性，同时在不影响稳定性的情况下为您提供新的功能，我们已经确保 SDK 完全覆盖了测试。我们将此包含在开源存储库中，以向您保证我们对质量的承诺，同时也希望您能贡献力量以保持其稳定性。这样做最简单的方法是提交错误报告并包含一个测试用例。

可以使用以下命令从基本目录执行测试

phpunit --stderr --bootstrap tests/bootstrap.php tests/tests.php

贡献力量

为了让我们接受您的贡献，您必须首先签署贡献者许可协议。

提交时，请确保所有行都少于 80 个字符，并尽可能遵循现有的样式。

在创建拉取请求之前，将您的提交合并为单个提交。

在需要的地方添加注释，并在提交信息中提供充分的说明。

报告问题/错误

错误

问题