Package Data | |
---|---|
Maintainer Username: | adeb6600 |
Maintainer Contact: | inbox@mahmoudzalt.com (Mahmoud Zalt) |
Package Create Date: | 2015-12-03 |
Package Last Update: | 2015-12-03 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-22 03:10:10 |
Package Statistics | |
---|---|
Total Downloads: | 20 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 0 |
Total Watchers: | 2 |
Total Forks: | 0 |
Total Open Issues: | 0 |
vinelab/url-shortener
is a PHP framework agnostic Package that makes it easy to shorten your URL's, with your favourite URL Shortening provider such as (Bit.ly, Goo.gl, Ow.ly).
The URL Shortening Providers are online services that takes long URLs and squeezes them into fewer characters to make the link easier to share, tweet, or send by email.
The package requires PHP 5.4+ and comes bundled with a Laravel 5 Facade and a Service Provider to simplify the optional framework integration and follows the FIG standard PSR-4 to ensure a high level of interoperability between shared PHP code and is fully unit-tested.
The recommended way to install this package is via Composer
.
A. Run this composer command:
composer require vinelab/url-shortener:*
B. Or manually add the package to your composer.json
and run composer update
.
{
"require": {
"vinelab/url-shortener": "*"
}
}
url-shortener
is framework agnostic and as such can be integrated easily natively or with your favorite framework.
The url-shortener
package has optional support for Laravel 5 and it comes bundled with a Service Provider for easier integration.
After you have installed the package correctly, just follow the instructions.
.1. Register the service provider in your config/app.php
:
'providers' => array(
...
'Vinelab\UrlShortener\UrlShortenerServiceProvider'
),
The service provider will automatically alias the Vinelab\UrlShortener\Shorten
class, so you can easily use the Shorten
facade anywhere in your app.
.2. Publish the configuration file:
php artisan vendor:publish --provider ='Vinelab\UrlShortener\UrlShortenerServiceProvider'
.1. Open url-shortener.php
and select your default provider:
'default' => 'bitly',
.2. Then add your provider token:
'bitly' => [
'domain' => 'https://api-ssl.bitly.com',
'endpoint' => '/v3/shorten',
'token' => 'YOUR-TOKEN-HERE',
],
Note: It's very recommended to not add your token (any sensetive data) to the config file instead reference it to a .env
variable.
And to do so:
replace the 'token' => 'YOUR-TOKEN-HERE',
with 'token' => env('BITLY_TOKEN'),
open your .env
file and add the token variable there with the token value: BITLY_TOKEN=YOUR-TOKEN-HERE
.
add the variable BITLY_TOKEN=
to the .env.example
for other developers.
The easiest way is to use it is by the Shorten
facade.
$long_url = 'http://testing.tst/something/12345/something-else/54321';
$short_url = Shorten\Shorten::url($long_url); // returns the short version of the long_url as a string
To run the tests, run the following command from the project folder.
$ ./vendor/bin/phpunit
To add support for a new URL shortening provider:
Bitly
driver Vinelab\UrlShortener\Drivers\Bitly
class.README
fileIf you discover any security related issues, please email mahmoud@vinelab.com instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.