PHPackages                             mindbox/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. mindbox/sdk

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

mindbox/sdk
===========

Mindbox SDK for PHP

1.1.7(7mo ago)9213.2k—0.6%19[8 issues](https://github.com/mindbox-cloud/php-sdk/issues)[5 PRs](https://github.com/mindbox-cloud/php-sdk/pulls)1PHPPHP &gt;=8.0CI passing

Since Mar 11Pushed 7mo ago10 watchersCompare

[ Source](https://github.com/mindbox-cloud/php-sdk)[ Packagist](https://packagist.org/packages/mindbox/sdk)[ RSS](/packages/mindbox-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (50)Used By (1)

Mindbox PHP SDK
===============

[](#mindbox-php-sdk)

PHP библиотека для упрощённого взаимодейтсвия вашего PHP приложения с API Mindbox. С полной документацией API Mindbox можно ознакомиться [здесь](https://developers.mindbox.ru/docs/v3).

Начало работы
-------------

[](#начало-работы)

### Зависимости

[](#зависимости)

- PHP версии 7.3 или выше
- [psr/log](https://github.com/php-fig/log)
- [ext-json](http://php.net/manual/ru/json.installation.php)
- [ext-simplexml](http://php.net/manual/ru/simplexml.installation.php)
- [ext-libxml](http://php.net/manual/ru/libxml.installation.php)
- [ext-curl](http://php.net/manual/ru/curl.installation.php) (опционально)

### Установка

[](#установка)

Вы можете установить Mindbox SDK двумя способами: используя Composer или скачав архив. Первый способ предпочтительнее, так как позволяет обновить библиотеку одной командой.

#### Composer (рекомендуемый способ)

[](#composer-рекомендуемый-способ)

Mindbox PHP SDK можно установить с помощью менеджера зависимостей [Composer](https://getcomposer.org/), используя следующую команду:

```
composer require mindbox/sdk
```

Для установки Mindbox PHP SDK в проекты, которые работают на PHP версии &gt;=5.6 и &lt; 7.3 необходимо использовать версию 1.0.7. Для этого выполнить следующую команду:

```
composer require "mindbox/sdk:^1.0.7"
```

#### Установка вручную

[](#установка-вручную)

1. [Скачайте архив](https://github.com/mindbox-cloud/php-sdk/releases/download/1.1.3/php-sdk.zip), содержащий исходный код проекта (включая зависимости).
2. Распакуйте в директорию вашего проекта.
3. Подключите автозагрузчик классов в начале вашего скрипта:

```
require_once __DIR__ . '/path/to/mindboxSDK/vendor/autoload.php';
```

Использование
-------------

[](#использование)

Обязательные параметры конфигурации SDK:

- `{logsDir}` - директория для логов
- `{endpointId}` - уникальный идентификатор сайта/мобильного приложения/и т.п. Значение нужно уточнить у менеджера Mindbox.
- `{secretKey}` - секретный ключ, соответствующий endpointId. Значение нужно уточнить у менеджера Mindbox.
- `{domainZone}` домен API Mindbox, на который будут отправляться запросы

Опциональные параметры:

- `{timeout}` таймаут соединения http запроса (в секундах), опционально. По умолчанию 5 секунд.
- `{httpClient}` способ отправки запроса ("curl", "stream"), опционально. По умолчанию curl, если установлено расширение ext-curl, иначе stream.

### Инициализация SDK

[](#инициализация-sdk)

```
$logger = new \Mindbox\Loggers\MindboxFileLogger('{logsDir}');

$mindbox = new \Mindbox\Mindbox([
    'endpointId' => '{endpointId}',
    'secretKey' => '{secretKey}',
    'domainZone' => '{domainZone}',
    //'timeout' => '{timeout}',
    //'httpClient' => '{httpClient}',
], $logger);
```

Подробнее о конфигурации и инициализации SDK [здесь](docs/getting_started.md).

### Использование хелперов для стандартных операций

[](#использование-хелперов-для-стандартных-операций)

Для стандартных операций Mindbox реализован набор хелперов, упрощающий осуществление запросов. Простой пример отправки запроса авторизации потребителя к Mindbox с использованием хелпера:

```
$logger = new \Mindbox\Loggers\MindboxFileLogger('{logsDir}');

$mindbox = new \Mindbox\Mindbox([
    'endpointId' => '{endpointId}',
    'secretKey' => '{secretKey}',
    'domainZone' => '{domainZone}',
], $logger);

$customer = new \Mindbox\DTO\CustomerRequestDTO();
$customer->setEmail('test@test.ru');
$customer->setMobilePhone('77777777777');
$customer->setId('mindboxId', '1028');

try {
    $response = $mindbox->customer()
        ->authorize($customer, 'Website.AuthorizeCustomer')
        ->sendRequest();

    $requestBody = $response->getRequest()->getBody();
    $responseBody = $response->getBody();
} catch (\Mindbox\Exceptions\MindboxClientException $e) {
    echo $e->getMessage();
    return;
}
```

Подробнее об использовании хелперов SDK [здесь](docs/README.md#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D1%8B-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-sdk).

### Универсальные методы для отправки произвольных запросов

[](#универсальные-методы-для-отправки-произвольных-запросов)

Запросы, для которых не реализованы хелперы, можно выполнить с помощью универсальных методов:

```
$logger = new \Mindbox\Loggers\MindboxFileLogger('{logsDir}');

$mindbox = new \Mindbox\Mindbox([
    'endpointId' => '{endpointId}',
    'secretKey' => '{secretKey}',
    'domainZone' => '{domainZone}',
], $logger);

$operation = new \Mindbox\DTO\OperationDTO();

$customer = new \Mindbox\DTO\CustomerRequestDTO();
$customer->setEmail('test@test.ru');
$customer->setMobilePhone('77777777777');
$customer->setId('mindboxId', '1028');

$operation->setCustomer($customer);

try {
    $response = $mindbox->getClientV3()
        ->prepareRequest('POST', 'Website.AuthorizeCustomer', $operation, '', [], false)
        ->sendRequest();
    $requestBody = $response->getRequest()->getBody();
    $responseBody = $response->getBody();
} catch (\Mindbox\Exceptions\MindboxClientException $e) {
    echo $e->getMessage();
}
```

Подробнее об использовании универсальных методов SDK [здесь](docs/README.md#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D1%8B-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-sdk).

Документация
------------

[](#документация)

Подробная документация библиотеки доступна по [ссылке](docs/README.md).

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance45

Moderate activity, may be stable

Popularity44

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 63.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~120 days

Recently: every ~269 days

Total

21

Last Release

227d ago

Major Versions

0.0.3 → 1.0.02021-01-21

1.0.0 → v2.2.0.x-dev2021-03-17

PHP version history (3 changes)0.0.0PHP ^5.6|^7.0

1.1.0PHP &gt;=7.3

1.1.4PHP &gt;=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/54c918de03f5b00d141fb1e4df72e10450f2e4f56af9db78adec049128cb70f9?d=identicon)[Mindbox](/maintainers/Mindbox)

---

Top Contributors

[![MaximBurcev](https://avatars.githubusercontent.com/u/19308997?v=4)](https://github.com/MaximBurcev "MaximBurcev (134 commits)")[![IvanShishkin](https://avatars.githubusercontent.com/u/28643973?v=4)](https://github.com/IvanShishkin "IvanShishkin (49 commits)")[![QSOFT-DEVOLOPER](https://avatars.githubusercontent.com/u/47108376?v=4)](https://github.com/QSOFT-DEVOLOPER "QSOFT-DEVOLOPER (14 commits)")[![mindbox-travis](https://avatars.githubusercontent.com/u/48324013?v=4)](https://github.com/mindbox-travis "mindbox-travis (7 commits)")[![olegpro](https://avatars.githubusercontent.com/u/1092443?v=4)](https://github.com/olegpro "olegpro (4 commits)")[![MiXaLiN17](https://avatars.githubusercontent.com/u/16404829?v=4)](https://github.com/MiXaLiN17 "MiXaLiN17 (3 commits)")[![bkiyakov](https://avatars.githubusercontent.com/u/57826472?v=4)](https://github.com/bkiyakov "bkiyakov (1 commits)")

---

Tags

sdkmindbox

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/mindbox-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/mindbox-sdk/health.svg)](https://phpackages.com/packages/mindbox-sdk)
```

###  Alternatives

[aws/aws-crt-php

AWS Common Runtime for PHP

420300.1M4](/packages/aws-aws-crt-php)[infusionsoft/php-sdk

PHP SDK for the Infusionsoft

1292.1M7](/packages/infusionsoft-php-sdk)[zumba/amplitude-php

PHP SDK for Amplitude

409.5M5](/packages/zumba-amplitude-php)[amazon/instantaccess-sdk-php

Amazon Instant Access SDK for PHP

1432.8k](/packages/amazon-instantaccess-sdk-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
