alb/oembed

oEmbed consumer library

1.1.0 2013-03-27 20:37 UTC

README

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');