Laravel wrapper for the Facebook Graph PHP 8 SDK

Joel Butcher

Last update: Dec 8, 2022

Related tags

Third Party APIs laravel-facebook-graph

Overview

Laravel Facebook Graph SDK

Installation

Getting started with Laravel Facebook Graph is easy - first, install the package via composer

composer require joelbutcher/laravel-facebook-graph

Then publish the package config:

php artisan vendor:publish --provider="JoelButcher\Facebook\FacebookServiceProvider"

This will add a config/facebook.php file to your project. Here you may configure the following options:

Option	Description
`app_id`	Used to identify your app when requesting a users' access token
`app_secret`	The secret key used to authorize your app with Facebook
`redirect_url`	The destination URL to redirect users to, after authenticating with Facebook
`graph_version`	The graph version to target when making user-authenticated requests to the Facebook Graph API, defaults to v11.0
`beta_mode`	Indicates whether or not to run a beta version of the SDK

URL Detection Handler

You may add a custom URL Detection handler, by binding a singleton your implementation in the register method of the AppServiceProvider:

$this->app->singleton(UrlDetectionInterface::class, fn ($app) => $app[UrlDetectionHandler::class])

Persistent Data Handlers

In order to store the state for OAuth requests to Facebook, you will either need to register a persistent data handler. You can find an example of how to do this here

HTTP Client

The current version of the Facebook Graph SDK (v6) uses HTTPlug for making requests. If you wish to use your own HTTP Client, it MUST implment the Http\Client\HttpClient interface. Please refer to this example

Comments

Facebook permission popup is not working when adding the "publish_to_groups", "groups_access_member_info" scopes

Facebook permission popup is not working when I am adding the "publish_to_groups","groups_access_member_info" scopes (currently using laravel socialite package.)

For permission popup is working fine for these "pages_show_list","pages_read_engagement","pages_manage_posts","instagram_basic","public_profile","instagram_content_publish". (All permission has been approved by the Facebook).

Why Facebook permission popup is not working with these "publish_to_groups","groups_access_member_info" scopes?

opened by hemasharma05 3
[1.x] Allow scopes to be defined in config and merge with defaults
This PR adds loads any scopes defined in $this->app['config']->get('facebook.scopes') to JoelButcher\Facebook\Facebook in the FacebookServiceProvider::registerFacebook(). It also updates the HandlesAuthentication trait and updates the building of scopes in the redirect URL with the following:

$scopes = array_merge($this->config['scopes'] ?? [], [ 'email', 'public_profile', ]);

Fixes #8
opened by joelbutcher 3
HandlesAuthentication config scopes
I saw this reference to $this->config(['scopes']) in HandlesAuthentication.php, https://github.com/joelbutcher/laravel-facebook-graph/blob/18d0eec6111dcf1b7f0742b558746ee5cab67265/src/Traits/HandlesAuthentication.php#L56

thought i could just add something like

'scopes' => [ 'email', 'public_profile', 'publish_actions', ],

to my config/facebook.php and it would work but its never set since the service provider is redeclaring the config array rather than just merging config('facebook') with the other keys

https://github.com/joelbutcher/laravel-facebook-graph/blob/18d0eec6111dcf1b7f0742b558746ee5cab67265/src/FacebookServiceProvider.php#L120-L131
opened by dpslwk 2
Upload image from own server return "Missing or invalid image file"

When i try to upload images by post() func, it return this error with images which have my domain name in url, but worked well with other image urls from internet. Please help me to solve this problem

opened by haigooner95 1
Passing $scopes to Facebook ::redirectUrl() no longer get added to the request url

With the merge of #9 the $scopes parameter is ignored when calling array_merge.

To fix this, we need to add the array to the merge as the second param.

opened by joelbutcher 0
Documentation broken

Hello, Links are broken in documentation page here https://github.com/joelbutcher/laravel-facebook-graph/tree/1.x/docs. I don't understand how to use this package compared to the not laravel one.

opened by japafrite 3

Releases(v1.2.2)

v1.2.2(Oct 13, 2022)
What's Changed

[1.x] Allow v6 of symphony/http-client by @charlielangridge in https://github.com/joelbutcher/laravel-facebook-graph/pull/14

New Contributors

@charlielangridge made their first contribution in https://github.com/joelbutcher/laravel-facebook-graph/pull/14

Full Changelog: https://github.com/joelbutcher/laravel-facebook-graph/compare/v1.2.1...v1.2.2
Source code(tar.gz)
Source code(zip)
v1.2.1(Jun 14, 2022)
What's Changed

[1.x] Fix missing scopes passed to redirectUrl by @joelbutcher in https://github.com/joelbutcher/laravel-facebook-graph/pull/11

Full Changelog: https://github.com/joelbutcher/laravel-facebook-graph/compare/v1.2.0...v1.2.1
Source code(tar.gz)
Source code(zip)
v1.2.0(Jun 14, 2022)
What's Changed

[1.x] Allow scopes to be defined in config and merge with defaults by @joelbutcher in https://github.com/joelbutcher/laravel-facebook-graph/pull/9

Full Changelog: https://github.com/joelbutcher/laravel-facebook-graph/compare/v1.1.1...v1.2.0
Source code(tar.gz)
Source code(zip)
v1.1.1(Feb 9, 2022)
What's Changed

Add PHP 7.3 Support by @joelbutcher in https://github.com/joelbutcher/laravel-facebook-graph/pull/6

Full Changelog: https://github.com/joelbutcher/laravel-facebook-graph/compare/v1.1.0...v1.1.1
Source code(tar.gz)
Source code(zip)
v1.1.0(Feb 9, 2022)
What's Changed

Laravel 9 Support by @joelbutcher in https://github.com/joelbutcher/laravel-facebook-graph/pull/4

Full Changelog: https://github.com/joelbutcher/laravel-facebook-graph/compare/v1.0.0...v1.1.0
Source code(tar.gz)
Source code(zip)
v1.0.0(Aug 20, 2021)

Initial release
Source code(tar.gz)
Source code(zip)
1.0.0-beta1(Aug 1, 2021)

First beta release
Source code(tar.gz)
Source code(zip)