README

此包提供了一种方便的方法，通过使用适当的 Google 服务从任何网站提取 favicon。它允许您将其获取并保存到本地存储。

用法

用法非常简单。您可以通过依赖注入或使用外观。

• 对于依赖注入版本，对 FaviconExtractorInterface 进行类型提示。
• 对于外观版本，使用 FaviconExtractor 外观。

通用

• 如果找不到 favicon，则返回默认值。
• favicon 的扩展名始终是 .png。它不需要成为您文件名的一部分。

仅提取 favicon

$favicon = FaviconExtractor::fromUrl('https://laravel.net.cn')->fetchOnly();

它返回一个实现 FaviconInterface 的实例，您可以使用 $favicon->getContent() 获取 favicon 的原始内容。

获取并下载 favicon

如果您希望将 favicon 保存到本地存储，可以这样做。唯一的要求是定义 favicon 应该保存的路径。它相对于您在 config/filesystems.php 中定义的根路径。如果您保存路径是 favicons，它将被保存到 app/storage/favicons。

使用随机生成的文件名

FaviconExtractor::fromUrl('https://laravel.net.cn')->fetchAndSaveTo('favicons');
// returns favicons/HIgLtwL0iUdNkwfq.png

使用自定义文件名

FaviconExtractor::fromUrl('https://laravel.net.cn')->fetchAndSaveTo('favicons', 'myFilename');
// returns favicons/myFilename.png

安装

要安装此包，请通过 composer 需求它。

$ composer require digitonic/laravel-favicon-extractor

感谢 Laravel 5.5+ 包自动发现，无需手动添加 ServiceProvider。如果您不使用自动发现，请将 ServiceProvider 添加到 config/app.php 中的 providers 数组。

StefanBauer\LaravelFaviconExtractor\FaviconExtractorServiceProvider::class,

如果您想使用外观，请将以下内容添加到 config/app.php 中的 facades 数组。

'FaviconExtractor' => StefanBauer\LaravelFaviconExtractor\Facades\FaviconExtractor::class,

配置

如果您想修改配置，请使用 publish 命令将包配置复制过来。

php artisan vendor:publish --provider="StefanBauer\LaravelFaviconExtractor\FaviconExtractorServiceProvider" --tag="config"

配置文件中只有两个可更改的选项。即 provider_class 和 filename_generator_class。通常，没有必要更改它，除非您想有不同的实现方式来获取 favicon 和生成文件名。请确保实现相应的接口。

测试

$ vendor/bin/phpunit

更新日志

请查看 更新日志 了解最近的变化。

贡献

请参阅CONTRIBUTING以获取更多信息。

授权

MIT 许可证（MIT）。请参阅LICENSE以获取更多信息。