toin0u/concise

Concise your urls via extern providers

Concise

, _(*1)

Concise your urls via extern providers :), _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require toin0u/concise, <sub>(*4)</sub>

## Usage

Simple example using `Google` provider:

``` php
use Concise\Concise;
use Concise\Provider\Google;
use Ivory\HttpAdapter\GuzzleHttpAdapter;

$concise = new Concise(new Google(new GuzzleHttpAdapter));

// Returns the shortened URL
$concise->shorten('http://any.url');

// Returns the expanded URL
$concise->expand('http://short.ly/1234');

For full list of available adapters check the official documentation., <sub>(*5)</sub>

Currently supported providers:, <sub>(*6)</sub>

• Bitly
• Google
• Tinycc

Provider chaining

You can shorten a URL using multiple providers at once., <sub>(*7)</sub>

Make sure to add the Providers in the chain in the SAME ORDER for both shortening and expanding. Expanding is automatically done in a reversed order., <sub>(*8)</sub>

``` php use Concise\Concise; use Concise\Provider\Chain;, <sub>(*9)</sub>

$chain = new Chain;, <sub>(*10)</sub>

$chain->addProvider(/* add a Provider instance here /); $chain->addProvider(/ add another Provider instance here */);, <sub>(*11)</sub>

$concise = new Concise($chain);, <sub>(*12)</sub>

### Caching

When working with lots of URLs it probably makes sense to cache already shortened/expanded URLs. This way you can avoid unnecessary HTTP requests.

To use caching install [Stash](http://www.stashphp.com/) first:

``` bash
$ composer require tedivm/stash

``` php use Concise\Concise; use Concise\Provider\Cache; use Stash\Pool;, <sub>(*13)</sub>

$cache = new Cache(/* add a Provider instance here */, new Pool); $concise = new Concise($cache);, <sub>(*14)</sub>

## Testing

``` bash
$ phpspec run

Contributing

Please see CONTRIBUTING for details., <sub>(*15)</sub>

Credits

• Antoine Corcy
• Márk Sági-Kazár
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*16)</sub>