Download the PHP package antonowano/mindbox without Composer

On this page you can find all versions of the php package antonowano/mindbox. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of antonowano/mindbox

Informations about the package mindbox

Библиотека для интеграции с Mindbox API

Mindbox - это российская экосистема для email-, sms-, push-рассылок с персонализацией маркетинга и цен.

Эта библиотека предоставляет удобные классы для быстрой интеграции с API-методами Mindbox на PHP. А продуманные интерфейсы помогут быстро расширить функциональность библиотеки.

Установка

Библиотека зависит только от интерфейсов PSR. Для работы нужны реализации:

SilentApiClient оборачивает обычный клиент, ловит исключения и пишет их в лог вместо проброса наружу.

Параметры интеграции

Для работы клиента нужны:

Параметр Описание
endpointId Идентификатор эндпоинта в Mindbox
secretKey Секретный ключ API
defaultPrefix Префикс операций по умолчанию (например, Website.)
deviceUuid UUID устройства для операций с needDeviceUuid: true

В боевом приложении deviceUuid берётся из cookie mindboxDeviceUUID (его выставляет JS SDK Mindbox).

Примеры использования

Синхронный запрос (получить профиль)

Асинхронный запрос (просмотр товара)

Bulk-операция (массовое редактирование клиентов)

Эти же примеры с инициализацией можно найти в папке scripts/.

Свои классы

Для более элегантной работы с библиотекой лучше реализовывать собственные классы вместо DefaultIntegration, DefaultJsonOperation и других дефолтных реализаций. Интерфейсы Integration, AsyncOperation, SyncOperation и BulkOperation как раз для этого и предусмотрены.

CustomIntegration

Вместо DefaultIntegration можно описать своё поведение - например, читать deviceUuid из cookie:

ViewProduct

Вместо передачи массива в DefaultJsonOperation можно инкапсулировать операцию в отдельный класс:

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

Такой подход делает вызовы API читаемее: в код передаются доменные данные, а детали формирования запроса остаются в классе операции.

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

1. Установка пакета

Отдельно ставить Guzzle и логгер не нужно: в Laravel уже есть Guzzle (через фреймворк) и PSR-3 логгер (Log).

2. Переменные окружения

Добавьте в .env:

3. Настройка конфига

Добавьте секцию mindbox в config/services.php:

После изменения .env в production не забудьте пересобрать кэш конфигурации:

В коде значения читаются через config('services.mindbox.*'), а не через env() напрямую.

4. Регистрация в контейнере

В AppServiceProvider (или отдельном сервисе-провайдере):

Если вы не хотите обрабатывать исключения с помощью try..catch, тогда оберните зарегистрированный клиент классом SilentApiClient. Все Exception будут направлены в логгер, а само приложение не упадёт.

All versions of mindbox with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
ext-json Version *
psr/log Version ^1.0 || ^2.0 || ^3.0
psr/http-client Version ^1.0
psr/http-factory Version ^1.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package antonowano/mindbox contains the following files

Loading the files please wait ...