README

IconScoop helps you retrieve the favicon for any website by parsing HTML tags, inspecting web app manifests, or falling back to the /favicon.ico path. It even supports Google’s favicon service for protected domains. The service returns a Favicon object containing the icon URL (accessible via __toString()), the content location, and the HTTP status code. You can use the provided Laravel facade or instantiate the service directly.

Installation

You can install the package via composer:

composer require luminarix/iconscoop

You can publish the config file with:

php artisan vendor:publish --tag="iconscoop-config"

You can publish the assets with:

php artisan vendor:publish --tag="iconscoop-assets"

Usage

use Luminarix\IconScoop\Facades\IconScoop;

// Fetch the favicon
$favicon = IconScoop::find('https://x.com');

echo $favicon->imageUrl;    // e.g. 'https://www.facebook.com/favicon.ico'
echo $favicon->statusCode;  // e.g. 200
echo $favicon;              // string cast outputs the icon URL

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Luminarix Labs
• All Contributors

License

The MIT License (MIT). Please see License File for more information.