README

在您的 Symfony 应用程序中集成视频工具的几个辅助工具。

安装

composer require becklyn/video-platforms

使用

解析 URL

use Becklyn\VideoPlatforms\Parser\VideoUrlParser;


function parse (VideoUrlParser $parser, string $videoUrl)
{
    $video = $parser->parse($videoUrl);
}

存储

任何视频都将作为规范数组存储，并且可以从它中重新创建。有关更多信息，请参阅下面的“在实体中使用”。

还有一种基于字符串的简单序列化，尽管您将丢失初始格式

use Becklyn\VideoPlatforms\Video\Video;

$video = new Video("youtube", "123");

assert("youtube@123" === $video->serialize()); 

内部格式为 <platform>@<id>。这可以轻松存储在数据库中。

要反序列化，只需使用

use Becklyn\VideoPlatforms\Video\Video;

$serialized = "youtube@123";
$video = Video::unserialize($serialized);

assert("youtube" === $video->getPlatform());
assert("123" === $video->getId());
// will be autogenerate
assert("youtube@123" === $video->getUrl());

在实体中使用

您的实体应类似于以下内容

use Becklyn\VideoPlatforms\Validation\Constraint\VideoUrl;
use Becklyn\VideoPlatforms\Video\Video;

class MyEntity
{
    /**
     * @ORM\Column(name="video", type="json")
     *
     * @VideoUrl(platforms={"vimeo"})
     * @Assert\NotNull()
     */
     private ?array $video = null;

    /**
     */
    public function getVideo () : ?Video
    {
        return Video::createFromArray($this->video);
    }


    /**
     */
    public function setVideoUrl (?Video $video) : void
    {
        $this->video = null !== $video
            ? $video->toArray()
            : null;
    }
}

在表单中使用

在您的表单中应使用 VideoUrlType

use Becklyn\VideoPlatforms\Form\Type\VideoUrlType;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;

class MyForm extends AbstractType
{
    /**
     * @inheritDoc
     */
    public function buildForm (FormBuilderInterface $builder, array $options) : void
    {
        parent::buildForm($builder, $options);

        $builder
            ->add("video", VideoUrlType::class, [
                "label" => "video.label",
                "required" => true,
            ]);
    }
}

提示

在表单字段中输入值时，您始终可以使用字符串序列化版本，以避免解析冲突。例如，只需输入 vimeo@123。

验证

您可以在任何属性上使用 @VideoUrl() 注解。

/**
 * @VideoUrl()
 */

您还可以定义您想要允许的平台。使用平台键

/**
 * @VideoUrl(platforms={"vimeo"})
 */

注册自定义平台

实现 VideoUrlParserInterface 并使用自动配置或添加 DI 标签 becklyn.video-platforms.parser。

支持的格式

Vimeo

• 123456789（纯 ID，请注意冲突）
• https://vimeo.com/123456789

YouTube

• _1234567890（纯 ID，请注意冲突）
• https://www.youtube.com/watch?v=_1234567890
• https://www.youtube.com/v/_1234567890
• https://youtu.be/_1234567890
• https://www.youtube.com/oembed?url=http%3A//www.youtube.com/watch?v%3D_1234567890&format=json
• https://youtube.com/embed/_1234567890
• https://www.youtube.com/attribution_link?a=sgsfg&u=%2Fwatch%3Fv%3D_1234567890%26feature%3Dem-uploademail