bramin/cuttlylaravel

通过 Laravel 的 Http 帮助器和外观与 Cutt.ly API 交互


README

Latest Version on Packagist GitHub Code Style Action Status Total Downloads

Cutt.ly 是一个 URL 缩短服务。此包使用 Laravel 的 Http 帮助器与该服务交互,以创建、更新和删除缩略链接。

安装

您可以通过 composer 安装此包

composer require bramin/cuttlylaravel

您可以使用以下命令发布配置文件

php artisan vendor:publish --tag="cuttly-laravel-config"

这是发布配置文件的内容

return [
    'key' => '',
    'user_domain' => '0',
    'no_title' => '1',
    'public' => '1',
];

请确保将 key 设置为从 Cutt.ly 获得的密钥

用法

包含 Cuttly 外观

use Bramin\CuttlyPHP\Facades\Cuttly;

测试 API 状态

$success = Cuttly::ping();

创建新的链接

$details = Cuttly::create('https://google.com', '', false, true, true);

参数

  • short: 要缩短的 URL(必需)
  • name: 域名之后的第一和唯一 uri 段。传入 null 或空数组将生成一个随机且唯一的字符串。
  • userDomain: 是否应使用自定义域名而不是 cutt.ly。默认为 false
  • noTitle: 禁用标题查找以提高速度。默认为 true
  • public: 链接是公开的还是私有的。默认为 true

链接分析

$success = Cuttly::getAnalytics('https://cutt.ly/abcd', '2022-04-01', '2022-05-01');

参数

  • short: 要缩短的 URL(必需)
  • dateFrom: 设置返回数据的起始日期。格式:YYYY-MM-DD,例如:2021-03-02
  • dateTo: 设置返回数据的结束日期。格式:YYYY-MM-DD,例如:2021-03-02

给链接添加标签

$success = Cuttly::addTag('https://cutt.ly/abcd', 'tagname');

更新链接的来源

$success = Cuttly::updateSource('https://cutt.ly/abcd', 'http://www.google.com');

更新链接的标题

$success = Cuttly::updateTitle('https://cutt.ly/abcd', 'Google Home Page');

删除链接

$success = Cuttly::delete('https://cutt.ly/abcd');

测试

composer test

变更日志

请参阅 CHANGELOG 了解最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全漏洞

请查看 我们的安全策略 了解如何报告安全漏洞。

鸣谢

许可

MIT 许可证(MIT)。请参阅 许可文件 了解更多信息。