PHPackages                             3f/facebook-od - 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. [CLI &amp; Console](/categories/cli)
4. /
5. 3f/facebook-od

ActiveLibrary[CLI &amp; Console](/categories/cli)

3f/facebook-od
==============

Facebook Open Graph Object Debugger CLI.

1.0.1(8y ago)6331Apache-2.0PHPPHP &gt;=5.6.0

Since Mar 31Pushed 7y ago2 watchersCompare

[ Source](https://github.com/dedalozzo/facebook-od)[ Packagist](https://packagist.org/packages/3f/facebook-od)[ Docs](https://github.com/dedalozzo/facebook-od)[ RSS](/packages/3f-facebook-od/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/5c184353be27a61a6fdfb742b649aa28b11a46433bcecb763ac1ad4aaa6a52b8/68747470733a2f2f706f7365722e707567782e6f72672f33662f66616365626f6f6b2d6f642f762f737461626c652e706e67)](https://packagist.org/packages/3f/facebook-od)[![Latest Unstable Version](https://camo.githubusercontent.com/d13218947dfc18ca6ce51e0abf4123f513c668be17485b52a9d67d031aa52ef2/68747470733a2f2f706f7365722e707567782e6f72672f33662f66616365626f6f6b2d6f642f762f756e737461626c652e706e67)](https://packagist.org/packages/3f/facebook-od)[![Build Status](https://camo.githubusercontent.com/dd364e401acffb7399abfb8fe3e5574387acdee826ea296ad8b03e43bb6517c6/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f646564616c6f7a7a6f2f66616365626f6f6b2d6f642f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/dedalozzo/facebook-od/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/fbc3054ad180f54e802091c19dcdd913187585d83d1dfa80e9179b0ffca6cfc0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f646564616c6f7a7a6f2f66616365626f6f6b2d6f642f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/dedalozzo/facebook-od/?branch=master)[![License](https://camo.githubusercontent.com/a0ffa1843878fcf6110d94c8a2da8224eda1f48d04a376e6b3c9269a99b5e1d9/68747470733a2f2f706f7365722e707567782e6f72672f33662f66616365626f6f6b2d6f642f6c6963656e73652e737667)](https://packagist.org/packages/3f/facebook-od)[![Total Downloads](https://camo.githubusercontent.com/f79f6b113481d8e2962d3309d7cca9bd3f02f8f684aa49bb3499b2e341e67635/68747470733a2f2f706f7365722e707567782e6f72672f33662f66616365626f6f6b2d6f642f646f776e6c6f6164732e706e67)](https://packagist.org/packages/3f/facebook-od)

Facebook Object Debugger CLI
============================

[](#facebook-object-debugger-cli)

The Facebook Object Debugger CLI is command-line interface used to refresh the information of any page shared on Facebook. Unfortunately this operation can be done manually using the [Facebook Open Graph Object Debugger](https://developers.facebook.com/tools/debug/og/object/). To overcome this limitation I have created this command-line interface, using the official [Facebook SDK for PHP](https://github.com/facebook/php-graph-sdk).

Composer Installation
---------------------

[](#composer-installation)

To install Facebook Object Debugger CLI, you first need to install [Composer](http://getcomposer.org/), a Package Manager for PHP, following those few [steps](http://getcomposer.org/doc/00-intro.md#installation-nix):

```
curl -s https://getcomposer.org/installer | php
```

You can run this command to easily access composer from anywhere on your system:

```
sudo mv composer.phar /usr/local/bin/composer
```

Facebook Object Debugger CLI Installation
-----------------------------------------

[](#facebook-object-debugger-cli-installation)

Once you have installed Composer, it's easy install Facebook Object Debugger CLI.

1. Move into the directory where you prefer install Facebook Object Debugger CLI:

```
cd /usr/local
```

2. Create a project for Facebook Object Debugger CLI:

```
sudo composer create-project 3f/facebook-od
```

3. For your convenience create a symbolic link for the `fbod` executable in your `/usr/local/bin` directory:

```
sudo ln -s /user/local/facebook-od/bin/fbod.php /usr/local/bin/fbod
```

Supported Commands
------------------

[](#supported-commands)

Lists commands.

```
fbod list [--xml] [--raw] [--format="..."] [namespace]
```

Displays help for a command.

```
fbod help [--xml] [--format="..."] [--raw] [command_name]
```

Fetches new scrape information and update the Facebook cache.

```
fbod refresh [-i|--file[="..."]] [-u|--url[="..."]]
  [-d|--id[="..."]] [-s|--secret[="..."]] [-t|--token[="..."]]
  [-e|--encode]
```

Usage
-----

[](#usage)

Using the Facebook Object Debugger CLI is really simple. You can refresh a single URL or a bunch of URLs providing a text file with a list of URLs, one for each line.

```
fbod refresh -u http://www.example.com/foo-bar-123
```

```
fbod refresh -i urls.txt
```

You must also provide an **App ID**, an **App Secret** and an **App Access Token** or a **User Access Token**. To see your token please use the [Access Token Tool](https://developers.facebook.com/tools/access_token/). You can use both the App Access Token or the User Access Token, just keep in mind the first one does not expire. For your convenience you can rename (or copy) the `config.default.ini` to `config.ini`, then replace the values for your application. Otherwise you can provide those parameters using the designed options from the command-line.

Documentation
-------------

[](#documentation)

The documentation can be generated using [Doxygen](http://doxygen.org). A `Doxyfile` is provided for your convenience.

Requirements
------------

[](#requirements)

- PHP 5.4.0 or above.

Authors
-------

[](#authors)

Filippo F. Fadda -  -

License
-------

[](#license)

Facebook Object Debugger CLI is licensed under the Apache License, Version 2.0 - see the LICENSE file for details.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~243 days

Total

2

Last Release

3088d ago

PHP version history (2 changes)1.0PHP &gt;=5.4.0

1.0.1PHP &gt;=5.6.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/311248?v=4)[Filippo Fadda](/maintainers/dedalozzo)[@dedalozzo](https://github.com/dedalozzo)

---

Top Contributors

[![dedalozzo](https://avatars.githubusercontent.com/u/311248?v=4)](https://github.com/dedalozzo "dedalozzo (25 commits)")

---

Tags

cacheclidebuggerfacebookobjectopen-graphphprefreshscrapelinkfacebookdebugobjectcachedebuggershareupdatepostopen-graphrefresh

### Embed Badge

![Health badge](/badges/3f-facebook-od/health.svg)

```
[![Health](https://phpackages.com/badges/3f-facebook-od/health.svg)](https://phpackages.com/packages/3f-facebook-od)
```

###  Alternatives

[buggregator/trap

A simple and powerful tool for debugging PHP applications.

2591.7M40](/packages/buggregator-trap)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1322.1k12](/packages/mahocommerce-maho)[jonom/silverstripe-share-care

Social media sharing previews and customisation for Silverstripe

2932.7k1](/packages/jonom-silverstripe-share-care)

PHPackages © 2026

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