PHPackages                             haixin/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. haixin/surl

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

haixin/surl
===========

1.2(4y ago)119MITPHP

Since Jul 16Pushed 4y ago1 watchersCompare

[ Source](https://github.com/sunmingyang/surl)[ Packagist](https://packagist.org/packages/haixin/surl)[ Docs](https://github.com/sunmingyang/surl)[ RSS](/packages/haixin-surl/feed)WikiDiscussions main Synced 1mo ago

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

GeTui
=====

[](#getui)

[![Latest Version on Packagist](https://camo.githubusercontent.com/fab5fda9e58ab765cfe7869cf277d9b068d97cfddeec4f6d53c692d496a9cd47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68616978696e2f67657475692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/haixin/getui)[![Total Downloads](https://camo.githubusercontent.com/7c44b2cacace1e56f8257617ac942f9f7ade10e39869cbab725506291c12a2e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f68616978696e2f67657475692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/haixin/getui)[![Build Status](https://camo.githubusercontent.com/d04bff4d9afdc32d47c5e5b639eb505478b5c42bb3f882c9fb9e473675ae4f90/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f68616978696e2f67657475692f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/haixin/getui)[![StyleCI](https://camo.githubusercontent.com/cb13a877afd1dbe223c631789c3f922d3ace958fdb334a9cce9b26afefbc2ebd/68747470733a2f2f7374796c6563692e696f2f7265706f732f31323334353637382f736869656c64)](https://styleci.io/repos/12345678)

路线图
---

[](#路线图)

略。。。

安装
--

[](#安装)

```
$ composer require haixin/surl

artisan vendor:publish --provider="HaiXin\Surl\SurlServiceProvider"

# 修改 config/surl.php 后

artisan migrate
```

使用
--

[](#使用)

### 编码

[](#编码)

```
/********** 面向对象 **********/
use HaiXin\Surl\Facades\Surl;
$url = 'https://github.com/sunmingyang/surl';
$surl = Surl::url($url)
        //->expires('2021-07-16 00:00:00') 可以设置过期时间
        //->config($config) 可以传入config进行替换
        ->encode()
        ->save()
        ->toString();
print_r($surl); // OWKhm

/********** 面向过程 **********/
use function HaiXin\Surl\Helpers\surl_encode;
$surl = surl_encode($url); // 仅编码，不保存到数据库，返回短码

use function HaiXin\Surl\Helpers\surl_save;
$surl = surl_save($url); // 编码，保存到数据库，返回模型

use function HaiXin\Surl\Helpers\surl;
$surl = surl($url); // 编码，保存到数据库，返回完整地址
print_r($surl); // https:/localhost/s/OWKhm
```

### 解码

[](#解码)

```
use HaiXin\Surl\Facades\Surl;
$code = 'OWKhm';
$increment = true; // 每次解码，是否增加访问次数
$expires = true; // 失效是否允许访问

$url = Surl::decode($code, $increment, $expires); // 解码，返回原始地址
print_r($url); // https://github.com/sunmingyang/surl

use function HaiXin\Surl\Helpers\surl_decode;
$url = surl_decode($code); // 解码，返回原始地址
print_r($url); // https://github.com/sunmingyang/surl
```

更新日志
----

[](#更新日志)

[更新日志](changelog.md)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

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 ~2 days

Total

3

Last Release

1759d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/19c48a559d2908d1697950ea07febb92b5437a4025bca5fdc1b2cd284b17ecf0?d=identicon)[sunmingyang](/maintainers/sunmingyang)

---

Top Contributors

[![sunmingyang](https://avatars.githubusercontent.com/u/5117842?v=4)](https://github.com/sunmingyang "sunmingyang (5 commits)")

---

Tags

laravelshort url

### Embed Badge

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

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

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[nedwors/navigator

A Laravel package to ease defining navigation menus

433.1k](/packages/nedwors-navigator)[xefi/faker-php-laravel

Faker php integration with laravel

1915.1k](/packages/xefi-faker-php-laravel)[dcblogdev/laravel-junie

Install pre-configured guides for Jetbrains Junie

392.5k](/packages/dcblogdev-laravel-junie)

PHPackages © 2026

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