PHPackages                             joelbutcher/laravel-facebook-graph - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. joelbutcher/laravel-facebook-graph

ActiveLibrary[API Development](/categories/api)

joelbutcher/laravel-facebook-graph
==================================

Laravel wrapper for the Facebook Graph SDK for PHP 7.4 and PHP 8.

v1.5.0(1y ago)74160.5k↓53%16[2 issues](https://github.com/joelbutcher/laravel-facebook-graph/issues)[1 PRs](https://github.com/joelbutcher/laravel-facebook-graph/pulls)MITPHPPHP ^7.3|^8.0CI passing

Since Aug 1Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/joelbutcher/laravel-facebook-graph)[ Packagist](https://packagist.org/packages/joelbutcher/laravel-facebook-graph)[ Fund](https://paypal.me/joelbutcher)[ GitHub Sponsors](https://github.com/joelbutcher)[ RSS](/packages/joelbutcher-laravel-facebook-graph/feed)WikiDiscussions 1.x Synced 3d ago

READMEChangelog (10)Dependencies (7)Versions (17)Used By (0)

Laravel Facebook Graph SDK
==========================

[](#laravel-facebook-graph-sdk)

 [ ![Build Status](https://github.com/joelbutcher/laravel-facebook-graph/workflows/tests/badge.svg) ](https://github.com/joelbutcher/laravel-facebook-graph/actions) [ ![Total Downloads](https://camo.githubusercontent.com/6b8fdaefd165cc1bc37c121c49a056434ca95ce496326515747f1d643e58dfa7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6f656c627574636865722f6c61726176656c2d66616365626f6f6b2d6772617068) ](https://packagist.org/packages/joelbutcher/laravel-facebook-graph) [ ![Latest Stable Version](https://camo.githubusercontent.com/065d7242d24015d4a26a87b642166483e821602e5a1a82713f8caffbe2193c71/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6f656c627574636865722f6c61726176656c2d66616365626f6f6b2d6772617068) ](https://packagist.org/packages/joelbutcher/laravel-facebook-graph) [ ![License](https://camo.githubusercontent.com/0815206879cfd3055e5953b9d3cbb3f5a8e62e2feaa6d4918d58900c000884bc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6a6f656c627574636865722f6c61726176656c2d66616365626f6f6b2d6772617068) ](https://packagist.org/packages/joelbutcher/laravel-facebook-graph)

Installation
------------

[](#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:

OptionDescription`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 SDKURL Detection Handler
---------------------

[](#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
------------------------

[](#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](./docs/examples/persistent_data_storage.md)

HTTP Client
-----------

[](#http-client)

The current version of the Facebook Graph SDK (v6) uses [HTTPlug](http://httplug.io/) 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](./docs/examples/http_client.md)

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance68

Regular maintenance activity

Popularity48

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~146 days

Recently: every ~203 days

Total

13

Last Release

42d ago

PHP version history (2 changes)1.0.0-beta1PHP ^7.4|^8.0

v1.1.1PHP ^7.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/eb6903ee363d9201681e47a2dcbe12148b7d299dd9e37229cad774ecd923fd6e?d=identicon)[joelbutcher](/maintainers/joelbutcher)

---

Top Contributors

[![joelbutcher](https://avatars.githubusercontent.com/u/7163152?v=4)](https://github.com/joelbutcher "joelbutcher (14 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![dpslwk](https://avatars.githubusercontent.com/u/234460?v=4)](https://github.com/dpslwk "dpslwk (1 commits)")[![charlielangridge](https://avatars.githubusercontent.com/u/8578083?v=4)](https://github.com/charlielangridge "charlielangridge (1 commits)")[![rodrigoprimo](https://avatars.githubusercontent.com/u/77215?v=4)](https://github.com/rodrigoprimo "rodrigoprimo (1 commits)")[![slimani-dev](https://avatars.githubusercontent.com/u/25089144?v=4)](https://github.com/slimani-dev "slimani-dev (1 commits)")[![weiming85](https://avatars.githubusercontent.com/u/5578327?v=4)](https://github.com/weiming85 "weiming85 (1 commits)")

---

Tags

phplaravelfacebookphp8facebook-graphgraph-sdk

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/joelbutcher-laravel-facebook-graph/health.svg)

```
[![Health](https://phpackages.com/badges/joelbutcher-laravel-facebook-graph/health.svg)](https://phpackages.com/packages/joelbutcher-laravel-facebook-graph)
```

###  Alternatives

[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.9k3](/packages/defstudio-telegraph)[resend/resend-laravel

Resend for Laravel

1222.7M9](/packages/resend-resend-laravel)[wayofdev/laravel-symfony-serializer

📦 Laravel wrapper around Symfony Serializer.

2117.7k](/packages/wayofdev-laravel-symfony-serializer)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5022.0k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
