Embera - PHP Oembed消费者库

Embera是一个用PHP编写的Oembed消费者库，它能从文本中提取URL，并向匹配的服务查询媒体信息，然后嵌入相应的HTML。支持包括YouTube、Twitter、Livestream、Dailymotion、Instagram和Vimeo在内的超过150个站点。

安装

通过Composer安装最新稳定版本：

$ composer require mpratt/embera:~2.0

如果你不使用Composer，可以下载最新发布版或克隆本仓库，然后引入src/Autoloader.php文件。

require '....../Autoloader.php';

use Embera\Embera;

$embera = new Embera();

系统要求

• PHP >= 7.0（5.6版本也应可运行）
• 需要Curl扩展或者开启allow_url_fopen

基础用法

最常见、最基本的示例如下：

use Embera\Embera;

$embera = new Embera();
echo $embera->autoEmbed('嗨！你看过这个视频吗？https://www.youtube.com/watch?v=J---aiyznGQ 这是最棒的！');

这段代码会返回类似下面的HTML文本：

嗨！你看过这个视频吗？
<iframe
  width="459"
  height="344"
  src="https://www.youtube.com/embed/J---aiyznGQ?feature=oembed"
  frameborder="0"
  allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
  allowfullscreen
></iframe>
这是最棒的！

你还可以获取URL的Oembed数据：

use Embera\Embera;

$embera = new Embera();
print_r($embera->getUrlData([
    'https://vimeo.com/374131624',
    'https://www.flickr.com/photos/bees/8597283706/in/photostream',
]));

这将返回一个数组，包含了每个URL的相关详细信息。

文档

更多关于配置、使用方法和支持提供商的详细信息，请参阅以下文档：

• 使用与配置说明
• 支持的提供者
• 使用提供者集合
• 离线响应（假响应）
• 响应式嵌入
• 启用缓存
• 高级用法

升级指南

从1.9.x及以上版本迁移时请注意，目录结构已改变，库现在位于src文件夹中，并提供了非Composer环境下的自动加载器。配置数组已简化，请参考使用与配置说明进行更新。

另一个重大变化是inspectUrlInfo()方法现在改名为getUrlData()，HtmlFormatter类不再存在，因为库现在允许其他类型的模板处理。

升级过程应该相当简单，查看文档以了解更多信息。

提交问题和功能请求

在GitHub上跟踪错误和功能请求。

作者

Michael Pratt - [e-mail] - http://www.michael-pratt.com

查看贡献者列表，感谢所有参与此项目的人。

如果你喜欢这个库，觉得它对你有所帮助并想支持我，可以通过PayPal捐赠。

许可证

Embera遵循MIT许可协议，请查阅LICENSE文件了解详情。