Helper class to connect to Vimeo and download video information based on video ID or URL
This package provides a class with connection and helper functionality to allow gathering video information if you have the URL or ID. Made this just 'cause all those others out there were not to my particular liking.
This package was tested with
- PHP 7.3+ with ext-curl
- Laravel 8.0 (optional, but package includes an AddonServiceProvider for this)
Via Composer
composer require eleven59/vimeo-connectorThen add Vimeo key and secret to your .env file and you're good to go:
VIMEO_KEY="vimeo key"
VIMEO_SECRET="vimeo secret"This package includes a single static class that will help you connect to Vimeo and get all the info you need if you have a Video Id. Does not (yet) work for events. If you only have an Url, see Helper functions below. Isn't that convenient?
use Eleven59\VimeoConnector\VimeoConnector;
$video = VimeoConnector::getInfo($vimeoId);Instead of processing all that info yourself every time, why not use the built-in complementary function for that?
use Eleven59\VimeoConnector\VimeoConnector;
$stills = VimeoConnector::getStills($vimeoId);Now, why would you process all of those images yourself if you only want the biggest, baddest image on the block? This one returns the still that matches both the width and height of the video. It's probably the biggest and the best match. I know that's not always the best option, but it's a great approximation and there's always the function above if you need more nuance.
use Eleven59\VimeoConnector\VimeoConnector;
$cover = VimeoConnector::getCover($vimeoId);You can convert URLs to IDs for both events and videos. Isn't that great?
There are two ways to go about this. You can use the know-it-all function that will just give you an ID no matter if you use a video or event URL. If you need to validate that the link is either a video or an event, you are very welcome to try the separate functions instead.
use Eleven59\VimeoConnector\VimeoHelper;
$id = VimeoHelper::getIdFromUrl($url); // returns event or video Id or false
$eventId = VimeoHelper::getEventIdFromUrl($url); // returns event Id or false
$videoId = VimeoHelper::getVideoIdFromUrl($url); // returns video Id or falseIf you have either an Id or a full-fledged URL or even an embed code, these functions can translate any of those into either a Video URL or Ember URL, no questions asked.
use Eleven59\VimeoConnector\VimeoHelper;
$embedUrl = VimeoHelper::getEmbedUrl($urlOrId); // works for events and videos (returns event url if numeric input is given)
$eventEmbedUrl = VimeoHelper::getEventEmbedUrl($urlOrId); // works only for events
$videoEmbedUrl = VimeoHelper::getVideoEmbedUrl($urlOrId); // works only for videosBreaking changes will be listed here. For other changes see commit log.
This project was released under the MIT license, so you can install it on top of any Backpack & Laravel project. Please see the license file for more information.