README

新SDK发布

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

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

Facebook平台是一组API，可以使您的应用更加社交。

此仓库包含开源PHP SDK，允许您从PHP应用中访问Facebook平台。除非另有说明，Facebook PHP SDK在Apache License，版本2.0下授权（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个字符，并尽可能遵循现有风格。

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

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

报告问题/错误

错误

问题