Download the PHP package vinelab/url-shortener without Composer
On this page you can find all versions of the php package vinelab/url-shortener. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vinelab/url-shortener
More information about vinelab/url-shortener
Files in vinelab/url-shortener
Informations about the package url-shortener
URL Shortener PHP Package
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.
Highlights
- Supportes Bit.ly
Installation
The recommended way to install this package is via Composer
.
Via Composer
A. Run this composer command:
B. Or manually add the package to your composer.json
and run composer update
.
Integrations
url-shortener
is framework agnostic and as such can be integrated easily natively or with your favorite framework.
Laravel:
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
:
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:
Configuration
.1. Open url-shortener.php
and select your default provider:
.2. Then add your provider token:
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.
Usage
With Laravel:
The easiest way is to use it is by the Shorten
facade.
Test
To run the tests, run the following command from the project folder.
Contributing
Support new provider
To add support for a new URL shortening provider:
- write a driver for your URL Shortener service.
check the
Bitly
driverVinelab\UrlShortener\Drivers\Bitly
class. - add you driver configuration to the config file.
- write tests for your drvier.
- update the
README
file - check out the Contribution Guide for general details.
Support
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Abed Halawi
- Mahmoud Zalt
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of url-shortener with dependencies
illuminate/support Version 5.*
illuminate/config Version 5.*
symfony/finder Version ~2.7
vinelab/http Version 1.2.*