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(1y ago)019MITPHPPHP ^8.3.0

Since Jun 21Pushed 1y 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 today

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

28

—

LowBetter than 52% of packages

Maintenance49

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

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

377d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5484416?v=4)[Vladimir Kharinenkov](/maintainers/vhar)[@vhar](https://github.com/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

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[larastan/larastan

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

6.5k55.4M8.4k](/packages/larastan-larastan)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M151](/packages/laravel-mcp)[api-platform/laravel

API Platform support for Laravel

58171.5k14](/packages/api-platform-laravel)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k91.0k1](/packages/mike-bronner-laravel-model-caching)[illuminate/routing

The Illuminate Routing package.

1419.2M3.0k](/packages/illuminate-routing)

PHPackages © 2026

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