PHPackages                             facebook/facebook-instant-articles-sdk-extensions-in-php - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. facebook/facebook-instant-articles-sdk-extensions-in-php

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

facebook/facebook-instant-articles-sdk-extensions-in-php
========================================================

Facebook Instant Articles SDK Extensions in PHP to transform Instant Articles markup file into AMP

v0.2.1(8y ago)4180.3k35[6 issues](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/issues)[1 PRs](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/pulls)1proprietaryPHPPHP ^5.4 || ^7.0

Since May 25Pushed 7y agoCompare

[ Source](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php)[ Packagist](https://packagist.org/packages/facebook/facebook-instant-articles-sdk-extensions-in-php)[ Docs](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php)[ RSS](/packages/facebook-facebook-instant-articles-sdk-extensions-in-php/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (5)Versions (9)Used By (1)

Facebook Instant Articles SDK Extensions in PHP
===============================================

[](#facebook-instant-articles-sdk-extensions-in-php)

[![Build Status](https://camo.githubusercontent.com/17a9300e113bd95d5da60c8168840d91eeeaeb227f7acd8a5dc38559a6f13593/68747470733a2f2f7472617669732d63692e6f72672f66616365626f6f6b2f66616365626f6f6b2d696e7374616e742d61727469636c65732d73646b2d657874656e73696f6e732d696e2d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/facebook/facebook-instant-articles-sdk-extensions-in-php)[![Latest Stable Version](https://camo.githubusercontent.com/7896f543513fdf791c4c0c42cb1f800627e4db0b230715b5297f77c5ca431de0/68747470733a2f2f706f7365722e707567782e6f72672f66616365626f6f6b2f66616365626f6f6b2d696e7374616e742d61727469636c65732d73646b2d657874656e73696f6e732d696e2d7068702f762f737461626c65)](https://packagist.org/packages/facebook/facebook-instant-articles-sdk-extensions-in-php)

The Facebook Instant Articles SDK Extensions in PHP provides a native PHP interface for converting valid Instant Articles into AMP. This gives developers the ability to have AMP content right after getting his own Instant Article markup format ready.

The Extension package consists of:

- **Environment**: PHP &gt;= 5.4
- **Dependencies**: It relies solely on the [Instant Articles SDK](https://github.com/Facebook/facebook-instant-articles-sdk-php) and its dependencies to get the Instant Article markup format available into the Elements object tree structure. It also depends on [Composer](https://getcomposer.org/) dependency manager.
- **AMP**: The AMP transformation was based on the current implementation and definition from [AMP project](https://www.ampproject.org/).

Quick Start
-----------

[](#quick-start)

```
$ composer require facebook/facebook-instant-articles-sdk-extensions-in-php
```

After the installation, you can include the auto loader script in your source with:

```
require_once('vendor/autoload.php');
```

Also be sure to check [the quick start example](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/blob/master/examples/example-quick-start.php).

Official Documentation
----------------------

[](#official-documentation)

You can find examples on how to use the different components of this SDK to integrate with your CMS in the [Quick Start Guide](https://developers.facebook.com/docs/instant-articles/other-formats/#quickstart) of the [documentation](https://developers.facebook.com/docs/instant-articles/other-formats/).

Contributing
------------

[](#contributing)

Clone the repository

```
$ git clone https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php.git
```

[Composer](https://getcomposer.org/) is a prerequisite for testing and developing. [Install composer globally](https://getcomposer.org/doc/00-intro.md#globally), then install project dependencies by running this command in the project's root directory:

```
$ composer install
```

To run the tests:

```
$ composer test
```

To fix and check for coding style issues:

```
$ composer cs
```

Extra lazy? Run

```
$ composer all
```

to fix and check for coding style issues, and run the tests.

If you change structure, paths, namespaces, etc., make sure you run the [autoload generator](https://getcomposer.org/doc/03-cli.md#dump-autoload):

```
$ composer dump-autoload
```

---

**For us to accept contributions you will have to first sign the [Contributor License Agreement](https://code.facebook.com/cla). Please see [CONTRIBUTING](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/blob/master/CONTRIBUTING.md) for details.**

---

Troubleshooting
---------------

[](#troubleshooting)

If you are encountering problems, the following tips may help in troubleshooting issues:

- If your images are having dimension/aspect ratio problems, please check the [the quick start example](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/blob/master/examples/example-quick-start.php) for more information.
- At the moment, we have no way to determine a video's width and height, you need to explicitly pass that information via properties, see how to do it [here](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/blob/master/examples/example-quick-start.php).

### Filing an issue

[](#filing-an-issue)

- Be sure you've looked for the similar issue into the [Issues list](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/issues)
- Inform the Canonical URL of your Instant Article being converted
- Inform the [exported JSON from the style editor](https://developers.facebook.com/docs/instant-articles/other-formats#style)

Issue template:

```
# Issue Data
Instant Article Canonical URL: `http://yourdomain.com/path/article.html`
Exported Style JSON: `{...}`
Page ID: `12345`

# Problem noticed
1. Image XYZ missing

# Expected result
1. The Image XYZ should be present.

```

License
-------

[](#license)

Please see the [license file](https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php/blob/master/LICENSE) for more information.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity41

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 64.2% 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 ~86 days

Total

4

Last Release

3067d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3757713?v=4)[Joel Marcey](/maintainers/JoelMarcey)[@JoelMarcey](https://github.com/JoelMarcey)

![](https://www.gravatar.com/avatar/456e40a47e2bfad8ea7ac69a9f56b7331e9420ccd05fc0ca28ddfc96fc2ba77b?d=identicon)[chrisackermann](/maintainers/chrisackermann)

![](https://www.gravatar.com/avatar/5a9309a051a067daca385bb8875adde72185e39bc9d6462f380e7bff4007a922?d=identicon)[evertonrosario](/maintainers/evertonrosario)

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

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

![](https://www.gravatar.com/avatar/807c0639f0343b361c00cde136abcc25e65cd6e516e2c261005b61c1942a0a9a?d=identicon)[pestevez](/maintainers/pestevez)

![](https://www.gravatar.com/avatar/571717702a22a2b937b75e2d55a7ced8864ae61f3709737577d89a124f857bd2?d=identicon)[vkama](/maintainers/vkama)

---

Top Contributors

[![everton-rosario](https://avatars.githubusercontent.com/u/996519?v=4)](https://github.com/everton-rosario "everton-rosario (34 commits)")[![localheinz](https://avatars.githubusercontent.com/u/605483?v=4)](https://github.com/localheinz "localheinz (11 commits)")[![diegoquinteiro](https://avatars.githubusercontent.com/u/1878108?v=4)](https://github.com/diegoquinteiro "diegoquinteiro (3 commits)")[![flarnie](https://avatars.githubusercontent.com/u/1114467?v=4)](https://github.com/flarnie "flarnie (2 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (1 commits)")[![mburak](https://avatars.githubusercontent.com/u/944294?v=4)](https://github.com/mburak "mburak (1 commits)")[![timjacobi](https://avatars.githubusercontent.com/u/2023165?v=4)](https://github.com/timjacobi "timjacobi (1 commits)")

---

Tags

instantsdkfacebookampextensionsarticlesinstantarticles

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/facebook-facebook-instant-articles-sdk-extensions-in-php/health.svg)

```
[![Health](https://phpackages.com/badges/facebook-facebook-instant-articles-sdk-extensions-in-php/health.svg)](https://phpackages.com/packages/facebook-facebook-instant-articles-sdk-extensions-in-php)
```

###  Alternatives

[aws/aws-crt-php

AWS Common Runtime for PHP

423329.7M10](/packages/aws-aws-crt-php)[scottybo/laravel-facebook-sdk

Fully unit tested Facebook SDK v5 integration for Laravel 7.x

2225.4k](/packages/scottybo-laravel-facebook-sdk)

PHPackages © 2026

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