achais/shorturl

一键生成和还原短链接的 PHP 扩展包

维护者

详细信息

github.com/achais/shorturl

源代码

问题

安装次数: 171

依赖者: 0

建议者: 0

安全性: 0

星标: 14

关注者: 2

分支: 1

开放问题: 0

v1.0 2019-04-05 14:18 UTC

Requires

Requires (Dev)

MIT 06899a02cbbac9f4da22a667e77c695cb1af820d

  • achais <i.woop@achais.com>

This package is auto-updated.

Last update: 2024-09-19 08:53:12 UTC

README

一键生成和还原短链接的 PHP 扩展包，我们支持多平台了哦!

Build Status StyleCI build status

特点

  1. 支持目前市面多家服务商
  2. 一套写法兼容所有平台
  3. 简单配置即可灵活增减服务商
  4. 内置多种服务商轮询策略、支持自定义轮询策略
  5. 统一的返回值格式，便于日志与监控
  6. 自动轮询选择可用的服务商
  7. 更多等你去发现与改进...

平台支持

环境要求

  • PHP >= 5.6

安装

$ composer require achais/shorturl -vvv

使用

use Achais\ShortUrl\ShortUrl;

$config = [
    // HTTP 请求的超时时间（秒）
    'timeout' => 5.0,

    // 默认使用配置
    'default' => [
        // 网关调用策略，默认：顺序调用
        'strategy' => \Achais\ShortUrl\Strategies\OrderStrategy::class,

        // 默认可用的发送网关
        'gateways' => [
            'baidu',
        ],
    ],

    // 可用的网关配置
    'gateways' => [
        'baidu' => [
            'token' => '44712d2fdaaa48d0a717866e9a******',
        ],
        'weibo' => [
            'source' => '1771******',
        ],
        //...
    ],
];

$shortUrl = new ShortUrl($config);

// 长链接 -> 短链接
$long_url = 'https://www.achais.com';
$result = $shortUrl->shorten($long_url);
print_r($result);

// 短链接 -> 长链接
$short_url = 'https://dwz.cn/ZzVmHQZa';
$result = $shortUrl->expand($short_url);
var_dump($result);

各平台配置说明

百度 短链

'baidu' => [
    'token' => ''
],

微博 短链

'weibo' => [
    'source' => ''
],

贡献

您可以通过以下三种方式之一做出贡献

  1. 使用 问题跟踪器 提交错误报告。
  2. 在 问题跟踪器 上回答问题或修复错误。
  3. 贡献新功能或更新wiki。

代码贡献流程并不非常正式。您只需确保遵循PSR-0、PSR-1和PSR-2编码规范。任何新的代码贡献都必须附带适用的单元测试。

许可

MIT