README

从您到 Facebook 平台的更简洁、更有组织的桥梁。

简介

Laravel Facebook 是为需要快速、独立且安全的 Facebook 平台集成开发的开发者提供的最简单解决方案。自 2014 年 4 月 28 日起使用 Facebook PHP SDK v4，Laravel Facebook 在您和平台之间建立了更简洁、更有组织的中介。

'它只建立一个桥梁。您必须通过它。' -- 我

所需知识

Facebook 平台主要利用他们的 Graph API 来获取 Facebook 社交图谱中的数据。为了深入了解这个包，您需要了解访问令牌和 Facebook 权限的基本知识，但不用担心，这实际上并不难。

安装

所需步骤

在 master composer.json 文件的 require 键中添加以下内容。

"facebook/php-sdk-v4" : "4.0.*",
"welderlourenco/laravel-facebook" : "dev-master"

运行 Composer 更新命令

composer update

完成此操作后，最终步骤是在 app/config/app.php 配置文件中添加 provider 和 alias。

return array(
  // ...
  'providers' => array(
    // At the end of this array, push Laravel Facebook provider:
    'WelderLourenco\Facebook\Providers\FacebookServiceProvider'
  ),
  'aliases' => array(
    // At the end of this array, push Laravel Facebook facade:
    'Facebook'				=> 'WelderLourenco\Facebook\Facades\Facebook'
  )
)

配置

运行配置发布命令

php artisan config:publish welderlourenco/laravel-facebook

转到您的应用程序中生成的配置文件

return array(	
    /*
	|--------------------------------------------------------------------------
	| facebook-php-sdk-v4
	|--------------------------------------------------------------------------
	|
	| Essential data provided for the facebook-php-sdk-v4. The app-id and 
	| app-secret won't even be touched by welderlourenco/laravel-facebook's 
	| package.
	|
	*/
	'appId'			=> '', // Id of your facebook app.
	'appSecret'		=> '', // Secret of your facebook app.
	'redirectUrl'	=> '' // Where to process the facebook answer.
);

可用方法/使用方法

在任何页面上，使用不带任何参数的 connect() 方法获取 FacebookRedirectLoginHelper 对象的实例，允许您调用其原生方法。

示例：获取登录 URL。

$FacebookRedirectLoginHelper = Facebook::connect();
echo $loginUrl = $FacebookRedirectLoginHelper->getLoginUrl();

Laravel Facebook 允许您连接这些方法，看起来更漂亮。

echo Facebook::connect()->getLoginUrl();

您可以将数组传递给 getLoginUrl 方法以定义作用域。

echo Facebook::connect()->getLoginUrl(array('email'));
// public_profile (default scope) and email

在重定向页面上，调用 process() 方法处理 Facebook 答案并获取 FacebookSession 对象的实例，允许您调用其原生方法。

示例：处理 Facebook 重定向，将其转换为长期访问令牌并获取访问令牌。

$accessToken = Facebook::process()->getLongLivedSession()->getToken();
// Now that you have the access token, do whatever you want with it, store in database or in a cookie, it is you call.

在任何页面上，再次使用 connect() 方法传递 accessToken 参数以获取 FacebookSession 对象的实例，允许您调用其原生方法。

示例：获取会话信息。

$accessToken = 'example-of-access-token';
dd(Facebook::connect($accessToken)->getSessionInfo());

在任何页面上使用 api() 方法传递 3 个参数以获取 GraphObject 对象，允许您调用其原生方法。

示例：处理 Facebook 重定向，将其转换为长期访问令牌并获取访问令牌和用户个人信息。

// FacebookSession, you'll need this to make any api calls.
$session = Facebook::process()->getLongLivedSession();
// Access Token
$accessToken = $session->getToken();
// User info
$user = Facebook::api($session, 'GET', '/me');

在任何页面上，在调用 connect() 或 process() 方法之前使用 change() 方法传递 2 个必需参数和 2 个可选参数以更改连接前的应用程序。

示例：从另一个应用程序获取登录 URL。

echo Facebook::change($newAppId, $newAppSecret, $optionalNewAppRedirectUrl)->connect()->getLoginUrl();

感谢

感谢上帝给了我写所有这些知识的能力。