如何使用官方 PHP SDK 创建短链接

短链接早已不仅仅是为了缩短 URL。

如今，它们广泛应用于数字营销、数据分析、业务自动化以及各种应用程序的集成。

如果您正在开发网站、CRM 系统、管理后台、邮件营销平台或企业内部工具，通过代码自动创建短链接远比手动操作更加高效。

Lix.li 提供了官方 PHP SDK，让您可以直接在 PHP 项目中创建短链接，同时支持自定义别名（Alias）、UTM 参数、标签以及更多高级功能。

本文将介绍如何使用 Lix.li 官方 PHP SDK 创建短链接，并展示最常见的使用方式。

什么是 Lix.li PHP SDK？

Lix.li PHP SDK 是官方提供的 PHP 开发库，用于调用平台的 REST API。

借助 SDK，开发者无需手动构造 HTTP 请求、处理 JSON 数据或解析 API 响应，只需调用简单的方法即可完成各种操作。

SDK 采用面向对象设计，可以大幅提升开发效率并简化代码维护。

GitHub 源代码： https://github.com/lix-url/php-sdk

官方 SDK 页面： https://lix.li/guanfang-de-php-sdk

安装

使用 Composer 安装 SDK。

composer require lix-url/php-sdk

安装完成后，只需创建客户端实例，即可开始调用 API。

创建一个简单的短链接

最简单的使用方式就是将一个长链接转换为短链接。

// Create a basic link
$result = $client->links()->create(
    'https://example.com'
);

SDK 会自动向 Lix.li API 发送请求，并返回包含新创建短链接信息的对象。

创建带有更多参数的短链接

很多时候，我们不仅需要生成短链接，还希望同时完成营销配置。 PHP SDK 支持一次调用完成所有操作。

$result = $client->links()->create(
    url: 'https://example.com',
    alias: 'summer-sale',
    utm: [
        'utm_source' => 'newsletter',
        'utm_medium' => 'email',
        'utm_campaign' => 'summer-sale',
    ],
    title: 'Marketing link',
    tags: ['marketing', '2026'],
    isPublic: true
);

上述示例使用了多个可选参数。

create() 方法支持哪些参数？

创建短链接的方法支持更多高级参数。

public function create(
    string  $url,
    ?string $alias = null,
    ?string $title = null,
    ?int    $groupId = null,
    array   $tags = [],
    array   $meta = [],
    array   $utm = [],
    array   $trackingPixelIds = [],
    ?string $activeBeforeDatetime = null,
    ?string $password = null,
    bool    $isPublic = true,
): LinkShortenResult

最常用的参数包括：

create() 方法返回什么？

该方法返回一个 LinkShortenResult 对象。 您可以从中获取：

• 创建后的短链接；
• 链接 ID；
• 原始 URL；
• API 使用额度；
• 已使用请求数；
• 剩余请求数。 这些信息可以直接用于页面展示，也可以继续在业务逻辑中使用。

什么时候应该使用 PHP SDK？

官方 SDK 特别适用于以下场景：

• 自动生成短链接；
• 商品或文章发布时自动创建链接；
• 自动添加 UTM 参数；
• 与 CRM 集成；
• 与 CMS 集成；
• SaaS 平台开发；
• 企业内部系统；
• 营销自动化。 对于绝大多数 PHP 项目来说，SDK 都比直接发送 HTTP 请求更加方便。

PHP SDK 还是 REST API？

PHP SDK 与 REST API 拥有完全相同的功能。 不过 SDK 具有许多优势：

• 更少的样板代码；
• 自动处理数据序列化；
• 面向对象接口；
• 代码更加清晰；
• 更容易维护；
• 开发效率更高。 因此，对于 PHP 项目，我们推荐优先使用官方 SDK。

相关链接

• GitHub PHP SDK：https://github.com/lix-url/php-sdk
• 官方 PHP SDK 页面：https://lix.li/guanfang-de-php-sdk

总结

借助 Lix.li 官方 PHP SDK，只需几分钟即可完成短链接集成。 安装 Composer 包，创建客户端，然后调用 links()->create() 即可开始使用。 随着业务的发展，您还可以轻松使用更多高级功能，例如自定义别名、UTM 参数、标签、Tracking Pixels、链接有效期等。 如果您正在开发 PHP 应用，希望无需手动处理 HTTP 请求即可快速集成短链接功能，那么官方 Lix.li PHP SDK 将是一个稳定、高效且易于维护的解决方案。