README

OEmbed is a PHP library to assist you retrieving data from providers that supports OEmbed.
It was built to be a successor of ricardofiorani/php-video-url-parser.

Installation

Install the latest version with

$ composer require ricardofiorani/oembed

Requirements

PHP 7.4
A PSR-18 implementation
A PSR-17 implementation of RequestFactory and UriFactory

Basic Usage

<?php declare(strict_types=1);

use Your\PSR7Implementation\Uri;
use RicardoFiorani\OEmbed\OEmbed;

require __DIR__ . '/vendor/autoload.php';

$service = new OEmbed();

$uri = new Uri('https://www.dailymotion.com/video/x804zfb?playlist=x6ymns');

$result = $service->get(
    $uri,
    480,
    300,
    ['omitscript' => true]
);

echo (string)$result; //will render the HTML (in case of "video" or "rich") or URL (in case of "photo")

Services supported (and tested)

Dailymotion
Deviantart.com
Facebook*
Gfycat
Giphy
Instagram*
Kickstarter
Me.me
Reddit
Soundcloud
Spotify
Twitch
Twitter
Vimeo
Youtube

*Facebook and Instagram requires authentication
Please see https://developers.facebook.com/docs/instagram/oembed
Also please see the example at the bottom of this doc

Services supported but not tested

23HQ
Abraia
Adways
Alpha App Net
Altru
amCharts Live Editor
Animatron
Animoto
Apester
ArcGIS StoryMaps
Archivos
Audioboom
AudioClip
Audiomack
AudioSnaps
Avocode
AxiomNinja
Backtracks
Beautiful.AI
Blackfire.io
Blogcast
Box Office Buz
BrioVR
Buttondown
Byzart Project
Cacoo
Carbon Health
CatBoat
Ceros
ChartBlocks
chirbit.com
CircuitLab
Clipland
Clyp
CoCo Corp
CodeHS
Codepen
Codepoints
CodeSandbox
CollegeHumor
Commaful
Coub
Crowd Ranking
Cyrano Systems
Daily Mile
Datawrapper
Deseret News
Didacte
Digiteka
Dipity
DocDroid
Dotsub
DTube
edocr
eduMedia
EgliseInfo
Embed Articles
Embedery
Embedly
Ethfiddle
Eyrie
Fader
Faithlife TV
Firework
FITE
Flat
Flickr
Flourish
Fontself
FOX SPORTS Australia
FrameBuzz
FunnyOrDie
Geograph Britain and Ireland
Geograph Channel Islands
Geograph Germany
Getty Images
Gifnote
GloriaTV
GT Channel
Gyazo
hearthis.at
hihaho
Homey
HuffDuffer
Hulu
iFixit
IFTTT
iHeartRadio
Indaco
Infogram
Infoveave
Injurymap
Inoreader
inphood
iSnare Articles
Issuu
ivlismusic
Jovian
KakaoTv
Kidoju
Kirim.Email
Kit
Kitchenbowl
Knacki
Knowledge Pad
LearningApps.org
Lille.Pod
Livestream
Ludus
MathEmbed
Matterport
MediaLab
Medienarchiv der Künste - Zürcher Hochschule der Künste
Mermaid Ink
Microlink
Microsoft Stream
MixCloud
Moby Picture
Modelo
MorphCast
Music Box Maniacs
myBeweeg
Namchey
nanoo.tv
Nasjonalbiblioteket
Natural Atlas
nfb.ca
Odds.com.au
Odesli (formerly Songlink)
Official FM
Omniscope
On Aol
Ora TV
Orbitvu
Oumy
Outplayed.tv
Overflow
OZ
Padlet
Pastery
PingVP
Pinpoll
Pixdor
Podbean
Polaris Share
Poll Daddy
Port
Portfolium
posiXion
Qualifio
Quiz.biz
Quizz.biz
RadioPublic
RapidEngage
ReleaseWire
Replit
RepubHub
ReverbNation
RiffReporter
Roomshare
RoosterTeeth
Rumble
Runkit
Sapo Videos
Screen9
Screencast.com
Screenr
ScribbleMaps
Scribd
SendtoNews
ShortNote
Shoudio
Show the Way, actionable location info
Simplecast
Sizzle
Sketchfab
SlideShare
SmashNotes
SmugMug
SocialExplorer
Soundsgood
SpeakerDeck
Spotful
Spreaker
Stanford Digital Repository
Streamable
StreamOneCloud
Sutori
Sway
TED
The New York Times
They Said So
TickCounter
TikTok
Toornament
Topy
Tuxx
tvcf
TypeCast
Typlog
Ubideo
University of Cambridge Map
UnivParis1.Pod
UOL
Ustream
uStudio, Inc.
Utposts
Uttles
VeeR VR
Verse
VEVO
VideoJug
Vidlit
Vidmizer
Vidyard
Viously
Viziosphere
Vizydrop
Vlipsy
VLIVE
Vlurb
VoxSnap
Wave.video
wecandeo
Wiredrive
Wistia, Inc.
wizer.me
Wokwi
Wootled
WordPress.com
Xpression
Yes, I Know IT!
YFrog
Zeplin
ZingSoft
ZnipeTV
Zoomable
Plus all not mentioned available on https://oembed.com/providers.json

Currently Supported PHP Versions

PHP 7.4 || PHP 8.0 || PHP 8.1

Facebook and Instagram requiring authentication

Yeah I know, it sucks having to create an FB app and generate a token.

Anyway, there is two ways (maybe more but I can only think of two now) of making this lib work with FB and IG.

Method 1

You make a custom HTTP client (implementing \Psr\Http\Client\ClientInterface) and instructs it to retrieve the token following Facebook guidelines.

Method 2

Easier way, you just send your Application ID and Secret as an extra parameter to the endpoint and that's it.

$service = new OEmbed();

$uri = new Uri('https://www.facebook.com/FacebookDeutschland/videos/2403439749688130/');

$result = $service->get(
    $uri,
    480,
    300,
    ['access_token' => `{$appId}|{$appSecret}`]
);

ricardofiorani / oembed

Maintainers

Details