library laravel-logo-fetcher {🖫 522, ⚐ 6, ★ 0}

mtr-design/laravel-logo-fetcher

Fetching companies' logos by their domain names

Thursday, June 22, 2017
by andonovn
Repository
8 Watchers
0 Stars
522 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
6 Versions
0 % Grown

The README.md

Laravel Logo Fetcher

Installation

Require this package with composer:, _(*1)

composer require mtr-design/laravel-logo-fetcher

Add the ServiceProvider to the providers array in config/app.php, _(*2)

MTRDesign\LaravelLogoFetcher\ServiceProvider::class,

Copy the package config to your local config with the publish command:, _(*3)

php artisan vendor:publish --provider="MTRDesign\LaravelLogoFetcher\ServiceProvider"

You now should have config/logo_fetcher.php file. You can open and tweak the configuration options, _(*4)

Usage

Resolve the \MTRDesign\LaravelLogoFetcher\LogoFetcher class from the container
Set a provider using the provider() method
Call the fetch() method to get the logo
You can chain with store() to save it using your default storage disk

If you want to directly store the logo:, _(*5)

$logoFetcher = app(\MTRDesign\LaravelLogoFetcher\LogoFetcher::class);
$logoFetcher->provider(Clearbit::class)
    ->fetch($domain)
    ->store();

If you want to just fetch the logo:, _(*6)

$logoFetcher = app(\MTRDesign\LaravelLogoFetcher\LogoFetcher::class);
$logo = $logoFetcher
    ->provider(Clearbit::class)
    ->fetch($domain)
    ->logo;

One extra example to illustrate the domain() helper and the path property, assuming that you injected the logo fetcher class:, _(*7)

$path = $this->logoFetcher
    ->provider(Clearbit::class)
    ->domain($domain)
    ->fetch()
    ->store()
    ->path;

Providers

You can define your own providers - just create a class and implement the MTRDesign\LaravelLogoFetcher\Providers\ProviderContract, _(*8)

Error handling

Different exceptions will be raised if the fetching fails but they all inherit from the \MTRDesign\LaravelLogoFetcher\Exceptions\LogoFetcherException. All are having human-readable messages and can be safely output to the client. You can find all the exceptions in the \MTRDesign\LaravelLogoFetcher\Exceptions namespace., _(*9)