Skip to content

Latest commit

 

History

History
333 lines (310 loc) · 5.57 KB

README.md

File metadata and controls

333 lines (310 loc) · 5.57 KB

OEmbed

Build Status Minimum PHP Version License Total Downloads Coding Standards

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}`]
);