Как создать короткую ссылку с помощью PHP SDK

Короткие ссылки давно стали не просто способом сократить длинный URL. Сегодня их используют для маркетинга, аналитики, автоматизации и интеграции с собственными приложениями. Если вы разрабатываете сервис, CRM, личный кабинет, email-рассылку или внутренний инструмент, удобнее создавать короткие ссылки программно, чем вручную.

Lix.li предоставляет официальный PHP SDK, который позволяет быстро создавать короткие ссылки прямо из PHP-кода, задавать алиасы, добавлять UTM-метки, теги и другие параметры.

В этой статье мы разберем, как создать короткую ссылку с помощью PHP SDK Lix.li и рассмотрим самые распространенные варианты использования.

Что такое PHP SDK Lix.li

PHP SDK Lix.li — это официальная библиотека для работы с REST API сервиса. Она избавляет разработчиков от необходимости вручную формировать HTTP-запросы, сериализовать JSON и обрабатывать ответы API.

SDK предоставляет удобный объектный интерфейс и значительно упрощает интеграцию.

Исходный код проекта доступен на GitHub:

https://github.com/lix-url/php-sdk

Подробнее о возможностях библиотеки можно узнать на официальной странице:

https://lix.li/oficialniy-php-sdk

Установка

Установите библиотеку через Composer.

composer require lix-url/php-sdk

После установки останется создать экземпляр клиента и можно начинать работу с API.

Создание простой короткой ссылки

Самый простой сценарий — сократить одну ссылку.

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

SDK автоматически отправит запрос в API Lix.li и вернет объект с информацией о созданной короткой ссылке.

Создание ссылки с дополнительными параметрами

Во многих случаях требуется не просто сократить ссылку, а сразу подготовить ее для маркетинговой кампании.

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
);

В данном примере используются дополнительные параметры.

Такой вариант отлично подходит для email-рассылок, рекламных кампаний, публикаций в социальных сетях и автоматической генерации ссылок. Обратите внимание, что некоторые параметры, такие как alias, доступны только в платных тарифах.

Какие параметры поддерживает метод 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

Наиболее полезные параметры:

Даже если сейчас вам необходимо только сокращение ссылок, SDK уже готов к более сложным сценариям использования.

Что возвращает метод

Метод возвращает объект LinkShortenResult.

Из него можно получить:

• созданную короткую ссылку;
• идентификатор ссылки;
• исходный URL;
• информацию о лимитах использования API;
• количество использованных запросов;
• количество оставшихся запросов.

Это позволяет сразу показать пользователю результат создания ссылки или использовать его в дальнейшей логике приложения.

Когда стоит использовать PHP SDK

Официальный SDK особенно удобен, если необходимо:

• автоматически создавать короткие ссылки;
• генерировать ссылки при создании товаров или статей;
• использовать UTM-разметку;
• интегрировать сокращение ссылок в CRM;
• подключить сокращение ссылок к CMS;
• работать с SaaS-платформами;
• создавать ссылки внутри корпоративных приложений;
• автоматизировать маркетинговые процессы.

Практически в любом PHP-проекте SDK удобнее, чем самостоятельная работа с HTTP-запросами.

SDK или REST API?

И PHP SDK, и REST API используют одинаковые возможности платформы.

Однако SDK имеет несколько преимуществ:

• меньше шаблонного кода;
• автоматическая сериализация данных;
• удобная работа с объектами;
• более читаемый код;
• проще сопровождать проект;
• быстрее разрабатывать новые функции.

Поэтому для PHP-проектов рекомендуется использовать именно официальный SDK.

Полезные ссылки

• PHP SDK на GitHub — https://github.com/lix-url/php-sdk
• Официальная страница PHP SDK — https://lix.li/oficialniy-php-sdk

Заключение

PHP SDK Lix.li позволяет начать работу с сокращением ссылок буквально за несколько минут.

Достаточно установить библиотеку через Composer, создать клиента и вызвать метод links()->create().

При необходимости вы можете сразу использовать дополнительные возможности платформы: пользовательские алиасы, UTM-метки, группы, теги, Tracking Pixels, ограничение времени действия ссылки и другие функции.

Если вы разрабатываете приложение на PHP и хотите быстро интегрировать сокращение ссылок без ручной работы с HTTP-запросами, официальный PHP SDK станет наиболее удобным и надежным решением.