PHPackages                             vhar/embed-video - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. vhar/embed-video

ActiveLibrary[Utility & Helpers](/categories/utility)

vhar/embed-video
================

Embed Video for Laravel is a package for create a URL for an embedded video and a URL for a cover image from various video hosting sites from a video URL in any format

v0.0.1(11mo ago)08MITPHPPHP ^8.3.0

Since Jun 21Pushed 11mo agoCompare

[ Source](https://github.com/vhar/embed-video)[ Packagist](https://packagist.org/packages/vhar/embed-video)[ RSS](/packages/vhar-embed-video/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

[Русский](README.ru.md) | English

Embed Video for Laravel
=======================

[](#embed-video-for-laravel)

The package is designed to create a URL for an embedded video and a URL for a cover image from various video hosting sites from a video URL in any format.
The package can be used both to process user-entered data before adding it to the database and to display the result on the page.
The package includes handlers for videos from YouTube, Rutube and VK Video.
If necessary, you can add your own handler classes for other video hostings.

Installation
------------

[](#installation)

Install the latest version with

```
composer require vhar/embed-video
```

Usage
-----

[](#usage)

Call the `handle` method of the `Vhar\EmbedVideo\Facades\EmbedVideo` facade, passing it the URL of the video in any format as an argument.

```
try {
    return EmbedVideo::handle('https://www.youtube.com/watch?v=gpn_4tWz1w8');
} catch (\Exception $exception) {
    return ['error' => $exception->getMessage()];
}
```

If the passed URL is successfully processed, the `handle` method will return an instance of `\Vhar\EmbedVideo\Handlers\EmbedDataDTO` class containing the ID, the URL for the embedded video, and the URL for the cover image.

```
{
  id: "gpn_4tWz1w8"
  video: "https://www.youtube.com/embed/gpn_4tWz1w8"
  cover: "https://img.youtube.com/vi/gpn_4tWz1w8/0.jpg"
}
```

or an exception with an error message, such as:

```
The argument is not valid URL-address to a YouTube video.

```

You can also call a specific handler using the `hosting` method passing an alias of an available handler as an argument.

```
try {
    return EmbedVideo::hosting('youtube')->handle('https://www.youtube.com/watch?v=gpn_4tWz1w8');
} catch (\Exception $exception) {
    return ['error' => $exception->getMessage()];
}
```

The following aliases are currently available:

- `youtube` for YouTube;
- `rutube` for Rutube;
- `vkvideo` for VK Video;

Validation
----------

[](#validation)

To validate the video URL, pass the validator an instance of the EmbedVideoRule class with your other validation rules:

```
use Vhar\EmbedVideo\Rules\EmbedVideoRule;

$request->validate([
    'name' => ['required', 'url', new EmbedVideoRule],
])
```

Creating your own class-handler
-------------------------------

[](#creating-your-own-class-handler)

Сreate a class implementing the interface `Vhar\EmbedVideo\Contracts\EmbedVideoInterface`.
In the `handle` method, create the code to handle the URL string. This method should return an instance of `\Vhar\EmbedVideo\Handlers\EmbedDataDTO` class containing a property with an identifier (`id`), a URL for the embedded video (`video`), and a URL for the cover image (`cover`).

```
public function handle(string $url): EmbedDataDTO
{
    ...
    return new EmbedDataDTO(
        id: $id,
        video: $embedURL,
        cover: $coverURL
    );
}
```

The `availableDomains` method must return an array with the hosting domain names for this handler.

```
public function allowedDomains(): array
{
    return [
        'youtu.be',
        'youtube.com',
    ];
}
```

Add your handler registration to the `register` method of the `App\Providers\AppServiceProvider` provider.

```
class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        ...
        \Vhar\EmbedVideo\Facades\VideoHosting::hosting('you_alias', \YouNamespace\YouClassHandlerService::class);
    }
}
```

Now, you can call the link handling from the new handler, just like for the built-in services, by calling the `handle` method of `Vhar\EmbedVideo\Facades\EmbedVideo` facade.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance52

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

332d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7cb86ced0dd215ec41f842d04348c32ebd2c80995754915083ffa695892c8d3c?d=identicon)[vhar](/maintainers/vhar)

---

Top Contributors

[![vhar](https://avatars.githubusercontent.com/u/5484416?v=4)](https://github.com/vhar "vhar (2 commits)")

---

Tags

phplaravelyoutuberutubeembed videovk video

### Embed Badge

![Health badge](/badges/vhar-embed-video/health.svg)

```
[![Health](https://phpackages.com/badges/vhar-embed-video/health.svg)](https://phpackages.com/packages/vhar-embed-video)
```

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k43.5M5.2k](/packages/larastan-larastan)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[josiasmontag/laravel-recaptchav3

Recaptcha V3 for Laravel package

2641.6M2](/packages/josiasmontag-laravel-recaptchav3)[monicahq/laravel-cloudflare

Add Cloudflare ip addresses to trusted proxies for Laravel.

3372.7M4](/packages/monicahq-laravel-cloudflare)[laragear/preload

Effortlessly make a Preload script for your Laravel application.

119363.5k](/packages/laragear-preload)[kra8/laravel-snowflake

Snowflake for Laravel and Lumen.

188402.3k6](/packages/kra8-laravel-snowflake)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)