alb-oembed icon indicating copy to clipboard operation
alb-oembed copied to clipboard

Simple PHP oEmbed consumer library with discovery support

PHP oEmbed consumer library

Build Status

Simple consumer library for oEmbed with discovery support.

Usage

In this example the library automatically discovers the oEmbed enpoint for the http://vimeo.com/31423544 resource, and asks for informations about the resource.

<?php

use Alb\OEmbed;

$response = OEmbed\Simple::request('http://vimeo.com/31423544', array(
    'maxwidth' => 400,
    'maxheight' => 300,
));

echo $response->getTitle();
echo $response->getHtml();

Advanced usage:

<?php

use Alb\OEmbed;

// instanciate a Provider from a known endpoint
$provider = new OEmbed\Provider('http://vimeo.com/api/oembed.json', 'json');

// request information about a resource
$response = $provider->request('http://vimeo.com/31423544');

The library is also capable of discovering the oEmbed enpoint from a resource URL (if the site supports it):

<?php

use Alb\OEmbed;

$discovery = new OEmbed\Discovery;
$provider = $discovery->discover('http://vimeo.com/31423544');

// or, using OEmbed\Simple:

$provider = OEmbed\Simple::getProvider('http://vimeo.com/31423544');