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(9mo ago)9250.3k↓39.7%20[8 issues](https://github.com/mindbox-cloud/php-sdk/issues)[6 PRs](https://github.com/mindbox-cloud/php-sdk/pulls)1PHPPHP &gt;=8.0CI failing

Since Mar 11Pushed 2mo 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 3d ago

READMEChangelog (10)Dependencies (4)Versions (54)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

55

—

FairBetter than 97% of packages

Maintenance56

Moderate activity, may be stable

Popularity45

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 60.9% 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

274d 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://avatars.githubusercontent.com/u/129468?v=4)[Mindbox GmbH](/maintainers/Mindbox)[@mindbox](https://github.com/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)")[![callmemars1](https://avatars.githubusercontent.com/u/86615975?v=4)](https://github.com/callmemars1 "callmemars1 (8 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

[symfony/lock

Creates and manages locks, a mechanism to provide exclusive access to a shared resource

514139.2M692](/packages/symfony-lock)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

564576.7k53](/packages/ecotone-ecotone)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[illuminate/broadcasting

The Illuminate Broadcasting package.

7127.2M208](/packages/illuminate-broadcasting)[logiscape/mcp-sdk-php

Model Context Protocol SDK for PHP

368116.8k12](/packages/logiscape-mcp-sdk-php)

PHPackages © 2026

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