Download the PHP package rabotaru/zagruzka-connector without Composer
On this page you can find all versions of the php package rabotaru/zagruzka-connector. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package zagruzka-connector
ZagruzkaConnector
Библиотека предназначена для отправки сообщений посредством сервиса Zagruzka.com.
Сообщения отправляются посредством REST-протокола сервиса Zagruzka, подробности того, что означают поля в
объекте Request
- см. в документации
к сервису.
TODO
Список нереализованных фич (будут доделываться по запросу):
- Viber и Whatsapp сообщения (message/data/instantContent)
- Дополнительные параметры Push-уведомлений
- CascadeChainLink
- ScheduleInfo
- Классы Sender не только для СМС
Самый простой вариант использования для отправки СМС
Hooks
Можно использовать хуки для дополнительной обработки в библиотеке (отправка событий статистики, логирование). Для этого надо реализовать соответствующие интерфейсы.
RestPreSendHook
- выполняется перед отправкой данных, должны возвращать значение true или false. Если такой хук вернет false - отправки не будет
RestPostSendHook
- выполняется после отправки данных, ничего не возвращает
Request
Класс RabotaRu\ZagruzkaConnector\RestRequest\Request
- это объектное представление запроса в API Zagruzka.com. (может не все поддерживать, см. TODO).
Пример того, как создается класс:
Response
Для того чтобы Response приходил, НЕОБХОДИМО указать notifyUrl в Request. Так же вы можете прописать такой URL в личном кабинете Zagruzka.com.
Можно настроить этот эндпоинт на запись метрик с помощью вашего коннектора - предлагаются три метода на выбор:
- у вас есть только строка в json:
processResponseByJson
- ваш фреймворк вам уже все разобрал в массив:
processResponseByArray
- ваш фреймворк вам может все разобрать в объект
RabotaRu\ZagruzkaConnector\RestResponse\Response
библиотеки - тогда воспользуйтесьprocessResponse
Что еще можно расширять
Можно заменить транспорт — достаточно реализовать интерфейс RabotaRu\ZagruzkaConnector\Transport\ITransport
, тогда при инстанцировании коннектора вы можете передать его.
Транспорт отправляет в заданный URL данные с помощью метода POST в формате json, так что его можно использовать и, например, для отправки событий в статистику.
Можно написать свой коллектор метрик — достаточно реализовать интерфейс RabotaRu\ZagruzkaConnector\Metrics\IMetric
, тогда при инстанцировании коннектора вы можете передать его.
Можно отнаследовать коннектор и переопределить в нем константы-префиксы метрик. Создавать свою реализацию IRestConnector
или переопределять метод sendByRest
в ZagruzkaConnector
не рекомендуется, так как именно там инкапсулирована вся логика записи метрик.
All versions of zagruzka-connector with dependencies
ext-json Version *
guzzlehttp/guzzle Version 6.5.*|^7.4
promphp/prometheus_client_php Version ^2.1
ramsey/uuid Version ^4.1