README

Powerful URL shortening tools in Laravel

Installation
Usage
- Changing the driver
- Adding your own drivers
Available drivers
- Bit.ly
- Firebase Dynamic Links
- Is.gd
- Ouo.io
- Polr
- Shorte.st
- TinyURL
- V.gd
Changelog
Security
Contributing
Credits
License

Installation

You can easily install this package using Composer, by running the following command:

composer require laracrafts/laravel-url-shortener

Requirements

This package has the following requirements:

PHP 7.1 or higher
Laravel 5.1 or higher

Laravel 5.5+

If you use Laravel 5.5 or higher, that's it. You can now use the package, continue to the usage section.

Laravel 5.1-5.4

If you're using an older version of Laravel, register the package's service provider to your application. You can do this by adding the following line to your config/app.php file:

'providers' => [
   ...
   LaraCrafts\UrlShortener\UrlShortenerServiceProvider::class,
   ...
],

Usage

The shortener can be retrieved from the container in two ways:

$shortener = app('url.shortener');
// or...
$shortener = url()->shortener();

Once you have an instance of the shortener, you can shorten your URLs:

// This will return your shortened URL as a string
$shortener->shorten(...);

// This will return a promise which will resolve to your shortened URL
$shortener->shortenAsync(...);

// You can also call shortening from Laravel's url component directly
url()->shorten(...);

// or...
app('url')->shorten(...);

// or even...
app('url.shortener')->shorten(...);

This package relies on Guzzle's promise library for its asynchronous shortening, read their documentation for more information.

You can also use dependency injection to inject the shortener into a method:

class MyController extends Controller
{
    public function myFunction(ShortenerManager $shortener)
    {
        $shortener->shorten(...);
    }
}

The shortener exposes the following methods:

Method	Description
`shorten`	Shorten the given URL
`shortenAsync`	Shorten the given URL asynchronously
`driver`	Retrieve a driver (e.g. `tiny_url`)
`extend`	Register your own driver

Changing the driver

You can change the default driver by setting URL_SHORTENER_DRIVER={driver} in your environment file or publishing the config file and changing it directly.

Adding your own drivers

Much like Laravel's core components, you can add your own drivers for this package. You can do this by adding the following code to a central place in your application (preferably a service provider).

public function boot(ShortenerManager $shorteners)
{
    $shorteners->extend('my_driver', function ($app, $config) {
       // Return your driver instance here
    });
}

Once you have registered your driver you can call it like any other driver.

If you wrote a custom driver that others might find useful (such as a public online shortener service), please consider adding it to the package via a pull request.

Available drivers

Below is a list of available drivers along with their individual specs:

Service	Driver name	Since version	Analytics	Monetization
Bit.ly	`bit_ly`	0.1.0	yes	no
Firebase Dynamic Links	`firebase`	0.2.0	yes	no
Is.gd	`is_gd`	0.2.0	yes	no
Ouo.io	`ouo_io`	0.2.0	yes	yes
Polr	`polr`	0.3.0	yes	no
Shorte.st	`shorte_st`	0.1.0	yes	yes
TinyURL	`tiny_url`	0.1.0	no	no
V.gd	`is_gd`	0.2.0	yes	no

Bit.ly

website

This driver runs on Bit.ly's API and currently only supports API version 4. The API requires an access token and currently only generic access tokens are supported. You can retrieve such tokens from your Bit.ly profile. If you have a paid Bit.ly account you will also be able to set the domain for your shortened URLs.

Variable	Description
`URL_SHORTENER_API_TOKEN`	Your Bit.ly API token
`URL_SHORTENER_PREFIX`	Your short URL domain

Firebase Dynamic Links

website

This driver runs on Firebase's API. The API requires an access token, a URI prefix and a suffix. You can access these information on you firebase console. The token accessible under the project settings as "Web API Key" and the prefixes can be defined and accessed under the Dynamic Links menu.

The suffix can have the value SHORT or UNGUESSABLE.

IMPORTANT! Links created via the API are not visible in the Firebase console. They are only accessible via the Analytics REST API.

Variable	Description	Default
`URL_SHORTENER_API_TOKEN`	Your Firebase API token
`URL_SHORTENER_PREFIX`	Your URL prefix
`URL_SHORTENER_STRATEGY`	The path component creation method	`UNGUESSABLE`

Is.gd / V.gd

website

This driver supports is.gd and v.gd trough their respective APIs. When link previews are enabled v.gd will be used, otherwise is.gd will be used.

Variable	Description
`URL_SHORTENER_ANALYTICS`	Enable or disable statistics

Ouo.io

website

This driver uses the Ouo.io API and requires an access token. The API allows for URL monetization via advertisements and provides analytics via its dashboard.

Variable	Description
`URL_SHORTENER_API_TOKEN`	Your Ouo.io API token

Polr

website

This driver uses the Polr API. The API requires an access token and a URI prefix.

Variable	Description
`URL_SHORTENER_API_TOKEN`	Your Polr API token
`URL_SHORTENER_PREFIX`	Your URL prefix

Shorte.st

website

This driver uses the Shorte.st API, which requires an access token. This API supports monetization of your URLs and can give you insight into your traffic via its dashboard.

Variable	Description
`URL_SHORTENER_API_TOKEN`	Your Shorte.st API token

TinyURL

website

This driver runs on the TinyURL API, which requires no additional setup. This driver is the package default.

Changelog

Please see CHANGELOG for more information what has been changed in recent versions.

Security

If you discover any security related issues, please email one of the authors instead of using the issue tracker. You can find the author emails in the composer.json.

laracrafts / laravel-url-shortener

Maintainers

Details

README

Installation

Requirements

Laravel 5.5+

Laravel 5.1-5.4

Usage

Changing the driver

Adding your own drivers

Available drivers

Bit.ly

Firebase Dynamic Links

Is.gd / V.gd

Ouo.io

Polr

Shorte.st

TinyURL

Changelog

Security

Contributing

Credits

License