PHPackages                             mniknab/surl - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mniknab/surl

ActiveLibrary[Utility & Helpers](/categories/utility)

mniknab/surl
============

SURL - Laravel Short Url

1.1.0(6y ago)5145MITPHPPHP >=7.2.0CI failing

Since Mar 9Pushed 6y ago3 watchersCompare

[ Source](https://github.com/mniknab/surl)[ Packagist](https://packagist.org/packages/mniknab/surl)[ RSS](/packages/mniknab-surl/feed)WikiDiscussions master Synced 5d ago

READMEChangelogDependencies (4)Versions (5)Used By (0)

 [![](https://camo.githubusercontent.com/e4a40967e40af801984611b6d55431ce69ed2514f2ff537d656282939ee3a1ef/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6d6e696b6e61622f696d6167652f75706c6f61642f76313538333833383034332f7375726c2d6c6f676f5f746f6b6d71692e706e67)](https://camo.githubusercontent.com/e4a40967e40af801984611b6d55431ce69ed2514f2ff537d656282939ee3a1ef/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6d6e696b6e61622f696d6167652f75706c6f61642f76313538333833383034332f7375726c2d6c6f676f5f746f6b6d71692e706e67)

[![Build Status](https://camo.githubusercontent.com/719adde3b4dbc6d783201749409bb93ec643266f39eeda88677f80102c4ed6db/68747470733a2f2f7472617669732d63692e636f6d2f6d6e696b6e61622f7375726c2e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/mniknab/surl)[![Coverage Status](https://camo.githubusercontent.com/2a3bf02b7eb336ae0cdb74463f1ecc1541a3f0c51a267e2998d835b1bc5afd54/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6d6e696b6e61622f7375726c2f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/mniknab/surl?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/98880f06efd774ea07c792c892654448c4ba377c5dfdf898e23bdaebb2e1c8f7/68747470733a2f2f706f7365722e707567782e6f72672f6d6e696b6e61622f7375726c2f762f737461626c652e737667)](https://packagist.org/packages/mniknab/surl)[![License](https://camo.githubusercontent.com/0c2db428121f705be79981432074835a7c0c372680d42e00f5d9db21eb64ee06/68747470733a2f2f706f7365722e707567782e6f72672f6d6e696b6e61622f7375726c2f6c6963656e73652e737667)](https://packagist.org/packages/mniknab/surl)

About Surl
----------

[](#about-surl)

**SURL** is a package allowing you to shorten urls.

*By [Mohammad Niknab](https://github.com/mniknab)*

Installation
------------

[](#installation)

### Composer

[](#composer)

You can install this package via Composer by running this command:

```
composer require mniknab/surl

```

### Laravel

[](#laravel)

#### Setup

[](#setup)

> NOTE : The package will automatically register itself if you're using Laravel >= v5.5, so you can skip this section.

Once the package is installed, you can register the service provider in `config/app.php` in the `providers` array:

```
'providers' => [
    ...
    Mniknab\Surl\SurlServiceProvider::class,
],
```

#### Artisan commands

[](#artisan-commands)

To publish the config, migrations and views files, run this command:

> To force publishing add `--force` flag.

```
php artisan vendor:publish --provider="Mniknab\Surl\SurlServiceProvider"

```

To create the tables, run this command:

```
php artisan migrate

```

Configuration
-------------

[](#configuration)

**Surl** configuration file can be found on `config/surl.php`

Usage
-----

[](#usage)

> NOTE: You can also use Surl as an API.

Go to `http://{your-project}/surl-management`

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

2258d ago

PHP version history (2 changes)1.0.0PHP >=7.1

1.0.2PHP >=7.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8305344cc49c82c6d285960ab62618d4e879cec4371e8674b6b724e7eb7e497e?d=identicon)[mniknab](/maintainers/mniknab)

---

Top Contributors

[![mniknab](https://avatars.githubusercontent.com/u/7448085?v=4)](https://github.com/mniknab "mniknab (16 commits)")

---

Tags

laravellaravel-packageshort-urlshortenersurlurlurl-shortenerurlshort urlshortShorturlsurl

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mniknab-surl/health.svg)

```
[![Health](https://phpackages.com/badges/mniknab-surl/health.svg)](https://phpackages.com/packages/mniknab-surl)
```

###  Alternatives

[yourls/yourls

Your Own URL Shortener

11.9k27.7k1](/packages/yourls-yourls)[spatie/url

Parse, build and manipulate URL's

73914.3M97](/packages/spatie-url)[jbroadway/urlify

A fast PHP slug generator and transliteration library that converts non-ascii characters for use in URLs.

6737.4M62](/packages/jbroadway-urlify)[league/uri-components

URI components manipulation library

31932.3M67](/packages/league-uri-components)[sabre/uri

Functions for making sense out of URIs.

29335.2M40](/packages/sabre-uri)[spomky-labs/base64url

Base 64 URL Safe Encoding/Decoding PHP Library

15439.5M49](/packages/spomky-labs-base64url)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)