arthurhoaro/favicon

PHP Library used to discover favicon from given URL

v1.2.2 2018-09-08 09:37 UTC

This package is auto-updated.

Last update: 2019-12-10 12:42:44 UTC


README

This library is based on Chris Shiflett work.

Here are the changes you can see in this version:

  • Cover more use case to find favicons
  • Composer support
  • Various technical changes and improvements
  • Unit tests

Requirements

Composer

Use Composer by adding the following lines in your composer.json:

"require": {
    "arthurhoaro/favicon": "~1.0"
}

Basic Usage

require_once('vendor/autoload.php');

$favicon = new \Favicon\Favicon();

echo $favicon->get('http://hoa.ro');
// Displays: http://hoa.ro/themes/hoaro/img/favicon.png
var_dump($favicon->get('http://nofavicon.tld', FaviconDLType::HOTLINK_URL));
// Returns false

You can avoid hotlinking by downloading the favicons:

$favicon = new \Favicon\Favicon();

// return the generated filename inside the cache folder
$favicon->get('http://hoa.ro', FaviconDLType::DL_FILE_PATH);
// return false
$favicon->get('http://nofavicon.tld');

Or directly get the raw image as a binary string:

$favicon = new \Favicon\Favicon();

// return the binary string of the downloaded favicon
$favicon->get('http://hoa.ro', FaviconDLType::RAW_IMAGE);
// return false
$favicon->get('http://nofavicon.tld');

Note: DL_FILE_PATH and RAW_IMAGE require the cache to be enabled.

Configure

You can setup cache settings:

$favicon = new Favicon();
$settings = array(
    // Cache directory
    'dir' => '/tmp/',
    // Cache timeout in seconds
    'timeout' => 86400,
    // Default image when no favicon is found
    'defaultico' => 'img/fav.ico'
);
$favicon->cache($settings);