包简介

Painless responsive embeds for videos, slideshows and more.

README 文档

README

Effortless responsive embeds for videos, slideshows and more.
Created by Ben Sampson

Requirements

Laravel 8 or newer
PHP 7.4.0 or newer

Installation

1. Composer

composer require bensampo/laravel-embed

2. Include styles

Somewhere inside the <head> element of the document, include:

<x-embed-styles />

If you'd prefer to include the styles in your own CSS file, you may copy the contents of styles.blade.php.

3. Publish views (optional)

If you'd like to edit any of the views you may publish them:

php artisan vendor:publish --provider="BenSampo\Embed\EmbedServiceProvider"

Once published they can be found in /resources/views/vendor/embed/.

Usage

Simply include the following blade component in your view making sure to pass the url attribute.

The url should be the public URL for the page you're trying to embed.

<x-embed url="https://www.youtube.com/watch?v=oHg5SJYRHA0" />

Setting the aspect ratio

By default most embedded services are shown at a ratio of 16:9. Some services may override this if they have a more appropriate default. However, you can always change this by passing in a ratio to the aspect-ratio attribute.

<x-embed url="https://www.youtube.com/watch?v=oHg5SJYRHA0" aspect-ratio="4:3" />

The aspect ratio is maintained at different viewport sizes.

Fallback

If no service exists to handle the URL a fallback view is rendered. You can customize this by publishing the views and editing /resources/views/vendor/embed/services/fallback.blade.php.

Validation

A validation rule can be used to check for a supported service in a given URL.

use BenSampo\Embed\Rules\EmbeddableUrl;

public function store(Request $request)
{
    $this->validate($request, [
        'url' => ['required', new EmbeddableUrl],
    ]);
}

You may specify a list of allowed services using the allowedServices method.

use BenSampo\Embed\Services\Vimeo;
use BenSampo\Embed\Services\YouTube;
use BenSampo\Embed\Rules\EmbeddableUrl;

public function store(Request $request)
{
    $this->validate($request, [
        'url' => [
            'required',
            (new EmbeddableUrl)->allowedServices([
                YouTube::class,
                Vimeo::class
            ])
        ],
    ]);
}

Embed Services

Laravel embed supports multiple popular embed services such as YouTube, Vimeo and Slideshare.

See the full list →

Please submit an issue (or better yet a PR!) if the service you'd like to embed is not listed.

bensampo/laravel-embed 适用场景与选型建议

bensampo/laravel-embed 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 175.57k 次下载、GitHub Stars 达 143，最近一次更新时间为 2020 年 08 月 24 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「package」「laravel」「embed」「bensampo」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 bensampo/laravel-embed 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 bensampo/laravel-embed 我们能提供哪些服务？

定制开发 / 二次开发

基于 bensampo/laravel-embed 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 bensampo/laravel-embed 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

code16/embed 2

Embed laravel blade component + validation

yarri/essence 0

Extracts information about medias on the web, like youtube videos, twitter statuses or blog articles.

professional-wiki/external-content 9

MediaWiki extension that allows embedding external content, specified by URL, into your wiki pages

ivopetkov/google-fonts-embed-bearframework-addon 0

Google Fonts embed addon for Bear Framework

florianrambur/discord-webhook 10

gurubob/ascii-table 2

Simple ASCII output of array data

bensampo/laravel-embed

包简介

关键字：