---
title: Как купить энергию TRON на PHP через TronSave SDK (2026)
description: "Покупка энергии TRON на PHP через официальный TronSave SDK: установка через Composer, типизированные модели, ретраи и rate limit, покупка в 4 вызова."
url: https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-php/
canonical: https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-php/
lang: ru-RU
datePublished: 2026-11-18T16:37:34+00:00
dateModified: 2026-11-18T16:37:34+00:00
author: TronSave
publisher: TronSave (https://tronsave.io/)
categories:
  - Руководства по TRON
keywords: купить энергию TRON на PHP
translations:
  en: https://blog.tronsave.io/how-to-buy-tron-energy-in-php-sdk-guide/
  es: https://blog.tronsave.io/es/comprar-energia-tron-con-php/
  pt: https://blog.tronsave.io/pt/comprar-energia-tron-com-php/
  zh: https://blog.tronsave.io/zh/php-goumai-bochang-nengliang/
  de: https://blog.tronsave.io/de/tron-energie-mit-php-kaufen/
---

# Как купить энергию TRON на PHP через TronSave SDK (2026)

Быстрее всего **купить энергию TRON на PHP** через официальный TronSave SDK: `composer require tronsave/sdk`, создайте клиент с API-ключом, оцените стоимость, разместите заказ и опрашивайте его до 100%. Четыре типизированных вызова, никакого «сырого» HTTP и самописных циклов повторов. В этом руководстве — вся интеграция: установка, значения по умолчанию, обработка ошибок и то, как заказ на самом деле оплачивается.

## Зачем это PHP-бэкенду

На PHP работает огромная часть коммерческого веба — магазины на WooCommerce, платёжные сервисы на Laravel, самописные биллинговые панели. Как только такой сервис начинает выплачивать или принимать **USDT (TRC-20)** в сети TRON, он упирается в ту же арифметику, что и все: каждый перевод расходует энергию, а недостающая энергия оплачивается сжиганием TRX по тарифам протокола. Так одна выплата в стейблкоине сжигает около 6,43 TRX, а получателю, у которого никогда не было USDT, — около 13,03 TRX (данные на ноябрь 2026 г.).

Аренда энергии прямо перед пакетом выплат обычно стоит лишь долю от сжигания. Если делать это из кода, сервис пополняет себя сам — никто не следит за дашбордом в 3 часа ночи, ни один пакет не встаёт из-за пустого кошелька. Если сначала хотите посмотреть на уровне эндпоинтов, прочитайте наше [руководство по автоматизации через API](https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-api/); эта статья описывает тот же процесс, но с типами PHP вместо «сырых» запросов.

![Рынок энергии, на котором PHP-бэкенд покупает энергию TRON через TronSave SDK](https://blog.tronsave.io/wp-content/uploads/2025/09/Energy-rental-interface-on-Tronsave-copy.png)

SDK размещает заказы на том же рынке энергии, что и веб-интерфейс. Источник: TronSave

## Что такое TronSave PHP SDK?

Это официальный PHP-клиент для TronSave API v2, опубликованный в Packagist как `tronsave/sdk` (версия 2.0.0, лицензия MIT, **PHP 8.1+**). Рядом с ним есть официальные SDK для TypeScript, Python, Java и Rust — все они оборачивают одни и те же эндпоинты с одинаковым поведением, и это проверяется общим кросс-языковым набором тестов на соответствие, а не вручную.

PHP-клиент небольшой, но рассчитан на продакшен:

-   **Типизированные результаты.** Ответы приходят в виде readonly-классов — `UserInfo`, `EstimateBuyResource`, `Order`, `OrderBookLevel`, — а не ассоциативных массивов, по которым приходится гадать.
-   **Настоящие enum.** `ResourceType`, `PriceTier`, `OrderType`, `OrderStatus` и `Network` — backed enum из PHP 8.1, поэтому опечатка становится фатальной ошибкой в месте вызова, а не ответом 400 от сервера.
-   **Транспорт PSR-18.** По умолчанию Guzzle, но можно подставить любой PSR-18-клиент — удобно, если у вашего фреймворка уже есть настроенный HTTP-стек с мониторингом.
-   **Встроенные повторы и rate limiting.** Оба механизма включены по умолчанию и описаны ниже.

## Установка и настройка

```
composer require tronsave/sdk
```

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

```
use Tronsave\TronsaveClient;
use Tronsave\Network;

$sdk = new TronsaveClient(
    apiKey: getenv('TRONSAVE_API_KEY'),
    network: Network::Testnet,   // Network::Mainnet to go live
    timeoutMs: 30000,            // default
    maxRetries: 3,               // default
);
```

`Network` несёт свой базовый URL, поэтому хостнейм в коде не прописывается: `Network::Testnet` указывает на тестовый API Nile, а `Network::Mainnet` — на продакшен. Разрабатывайте в тестнете, где ничего не стоит реальных TRX, а затем переключите enum.

Тот же enum предоставляет и `fundAddress()` — адрес для пополнения вашего предоплаченного баланса. Брать его из enum, а не вставлять строку в конфиг, — более безопасная привычка: адрес для депозита, скопированный из сообщения в чате или из результатов поиска, — классический способ потерять пополнение.

## Покупка энергии от начала до конца

Четыре вызова. Первый необязателен, но его стоит добавить в health check.

```
use Tronsave\TronsaveClient;
use Tronsave\Network;

$sdk = new TronsaveClient(apiKey: getenv('TRONSAVE_API_KEY'), network: Network::Mainnet);

// 1. Who am I, and can I afford this run?
$me = $sdk->getUserInfo();
// $me->id, $me->balance, $me->representAddress, $me->depositAddress

// 2. What will it cost? (no API key required for this call)
$est = $sdk->estimateBuyResource([
    'receiver'       => 'TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM',
    'resourceType'   => 'ENERGY',
    'resourceAmount' => 65000,
    'durationSec'    => 3600,
]);
// $est->estimateTrx, $est->unitPrice, $est->durationSec, $est->availableResource

// 3. Place the order.
$order = $sdk->buyResource(
    ['receiver' => 'TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM', 'resourceAmount' => 65000, 'durationSec' => 3600],
    ['allowPartialFill' => true, 'maxPriceAccepted' => 100],
);

// 4. Poll until the energy is actually delegated.
$status = $sdk->getOrder($order->orderId);
echo $status->fulfilledPercent;   // 100 = fully delegated
echo $status->remainAmount;       // 0 when nothing is left to fill
foreach ($status->delegates as $d) {
    // $d->delegator, $d->amount, $d->txid
}
```

Две детали в этом фрагменте особенно полезны. **`estimateBuyResource` не требует авторизации** — можно узнать цену покупки ещё до получения ключа, а запрос цены в «горячем» участке кода никогда не тратит лимит запросов на авторизацию. А второй аргумент `buyResource` — это массив опций: `allowPartialFill` позволяет заполнить заказ от нескольких поставщиков, а не ждать одного крупного, а `maxPriceAccepted` — ваш потолок в SUN за единицу, та самая граница между устойчивой интеграцией и интеграцией, которая переплачивает во время скачка цен.

Заказ не завершён, когда `buyResource` возвращает результат, — возвращается `orderId`. Делегирование приходит через несколько секунд. Опрашивайте `getOrder`, пока `fulfilledPercent` не достигнет 100, и только потом отправляйте перевод, которому нужна энергия.

## Значения по умолчанию и лимиты, которые стоит знать

| Параметр | Значение |
| --- | --- |
| Тип ресурса по умолчанию | `ENERGY` |
| Ценовой уровень по умолчанию | `MEDIUM` (также `FAST`, `SLOW` или цена в SUN) |
| Длительность по умолчанию | `259200` секунд — 3 дня |
| Минимальный заказ энергии | Должен быть **больше 64 000** |
| Rate limit на стороне клиента | 15 запросов/с; 1/с для `getExtendableDelegates` |
| Таймаут / повторы по умолчанию | 30 000 мс / 3 повтора |
| Формат `extendTo` | Unix-время в **секундах** |

Минимум в 64 000 проверяется *на стороне клиента*: слишком маленький заказ выбрасывает исключение ещё до HTTP-запроса, так что ошибочный цикл не потратит лимит запросов, раз за разом получая один и тот же отказ. Rate limiter тоже работает на стороне клиента — он сам распределяет ваши вызовы во времени, не дожидаясь ответа 429 от сервера.

## Обработка ошибок, которая выдержит продакшен

Любой сбой — это типизированное исключение, наследующее `Tronsave\TronsaveException`, с полями `->code`, `->status` и `->raw`:

| Исключение | Когда | Что делать |
| --- | --- | --- |
| `TronsaveAuthException` | 401 | Исправить ключ. Не повторять. |
| `TronsaveValidationException` | 400, неверные параметры | Исправить вызов. Не повторять. |
| `TronsaveBusinessException` | 400, отказ по существу | Прочитать `->code` и обработать по ветке. |
| `TronsaveRateLimitException` | 429 | Подождать `->retryAfterMs`. |
| `TronsaveNetworkException` | Сбой транспорта | Можно безопасно повторить. |

```
use Tronsave\{TronsaveBusinessException, TronsaveRateLimitException};

try {
    $order = $sdk->buyResource(['receiver' => $addr, 'resourceAmount' => 65000]);
} catch (TronsaveRateLimitException $e) {
    usleep($e->retryAfterMs * 1000);
} catch (TronsaveBusinessException $e) {
    $log->warning('order rejected', ['code' => $e->code, 'raw' => $e->raw]);
}
```

Такое разделение важно: оно без догадок показывает, что можно повторять. SDK уже сам повторяет временные ошибки — 408, 425, 429, 500, 502, 503 и 504 — с экспоненциальной задержкой и jitter, учитывая заголовок `Retry-After`, если сервер его присылает. То, что доходит до вашего блока `catch`, уже повторялось, так что исключения выше — именно те, по которым решение должен принять ваш код.

## Как оплачивается заказ

Есть два способа оплаты, и SDK выбирает между ними по тому, что вы передаёте:

-   **Предоплаченный баланс (рекомендуется для серверов).** Вызовите `buyResource` без `signedTx` — заказ авторизуется вашим API-ключом и списывается с баланса TronSave. Ваш приватный ключ TRON никогда не попадает в интеграцию — именно то, что нужно на веб-сервере.
-   **Ончейн-оплата каждого заказа.** Передайте `signedTx`, который вы сами собрали и подписали, и заказ будет оплачен этой транзакцией.

Клиент также предоставляет `getSignedTransaction()`, который подписывает на стороне сервера. Его собственный docblock советует подписывать локально, и к этому стоит прислушаться: этот вызов отправляет приватный ключ по сети. Для PHP-бэкенда предоплаченный баланс и проще, и безопаснее — используйте его.

## Продление вместо повторной покупки

Если уже полученное делегирование скоро истекает, продлить его дешевле, чем купить новый заказ. Вызовите `getExtendableDelegates()` с получателем и Unix-временем `extendTo`; он вернёт `isAbleToExtend`, `totalEstimateTrx` и payload `extendData`, который вы сразу передаёте в `extendRequest()`. Учтите более жёсткий лимит в 1 запрос в секунду для первого вызова — это единственный эндпоинт, который SDK ограничивает строже остальных.

Наше [руководство по функции Extend](https://blog.tronsave.io/ru/funkciya-extend-prodlenie-arendy-energii-tron/) объясняет, когда продление выгоднее повторной покупки.

## FAQ

### Какая версия PHP нужна?

PHP 8.1 или новее. SDK опирается на backed enum, readonly-свойства и именованные аргументы, которые появились в PHP 8.0 и 8.1.

### Нужен ли Guzzle?

Он используется по умолчанию, так что всё работает сразу. Но транспорт построен на PSR-18, поэтому можно подставить любой совместимый клиент — удобно, если в приложении уже есть настроенный клиент со своим логированием, прокси или политикой таймаутов.

### Можно ли тестировать, не тратя реальные TRX?

Да. Создайте клиент с `Network::Testnet` — и вы в тестовой сети Nile с отдельным API-хостом. Там ничего не стоит реальных денег. Для выхода в продакшен поменяйте одно значение enum.

### Сколько энергии покупать для перевода USDT?

Примерно 65 000 для получателя, у которого уже есть USDT, и около 130 000 для того, у кого их никогда не было, — см. [сколько энергии нужно для перевода USDT](https://blog.tronsave.io/ru/skolko-trx-nuzhno-dlya-perevoda-usdt/). Помните, что минимальный заказ — *больше* 64 000, так что 65 000 — наименьший практический заказ энергии.

### PHP SDK отстаёт от TypeScript-версии?

Нет. Все пять клиентов работают с одним и тем же API v2 одной версии и проходят общий набор тестов на соответствие, так что поведение между языками не расходится. Если вы пишете на нескольких языках, руководства по SDK для [TypeScript](https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-kod-tronsave-sdk/), [Java](https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-java/) и [Rust](https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-rust/) описывают тот же процесс.

### Что будет, если заказ заполнится только частично?

С включённым `allowPartialFill` вы получаете то, что смог предложить рынок, а `fulfilledPercent` показывает, сколько именно. Проверьте его перед отправкой транзакции, которой нужна энергия: частично заполненного заказа может не хватить на ваш перевод.

## Итог

Если ваш PHP-сервис переводит USDT в сети TRON, энергия — это постоянная статья расходов, которую можно сократить до 80%, а SDK превращает это в интеграцию из четырёх вызовов, а не в отдельный проект. Установите его, узнайте цену заказа без ключа, покупайте с предоплаченного баланса, чтобы приватный ключ не попадал на веб-сервер, и дождитесь 100% перед отправкой.

**Начните интеграцию:** выполните `composer require tronsave/sdk`, получите ключ в [панели TronSave](https://tronsave.io/ru) и оцените первый заказ на [живом рынке энергии](https://tronsave.io/ru/market).

*TronSave SDK публикует TronSave — издатель этого блога. Описанные здесь версии пакета, значения по умолчанию и лимиты соответствуют v2.0.0 и могут измениться в следующих релизах — сверьтесь с официальной документацией SDK, прежде чем фиксировать версию. Это не финансовая рекомендация.*
