Download the PHP package mix8872/rabbitmq-rpc without Composer
On this page you can find all versions of the php package mix8872/rabbitmq-rpc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mix8872/rabbitmq-rpc
More information about mix8872/rabbitmq-rpc
Files in mix8872/rabbitmq-rpc
Package rabbitmq-rpc
Short Description Json RPC implementation over rabbitmq
License MIT
FAQ
Example:
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 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.
Informations about the package rabbitmq-rpc
Реализация JSON RPC через RabbitMQ
Способ позволяет выполнять функции с аргументами на удаленном сервисе (или группе сервисов).
Зависимости:
- php 8.*
- php-amqplib
needle-project/laravel-rabbitmq,
используется форк[email protected]:mix8872/laravel-rabbitmq.gitв котором сняты ограничения на максимальное время работы и количество запросов
Принцип работы
Для выполнения процедур используется json формат сообщения rmq, который содержит следующие поля:
- 'request_id' => 'string|required' | ID запроса - добавляется автоматически
- 'reply_to' => 'string|required' | имя маршрута rmq для ответа - добавляется автоматически из
config('app.name')
на этот маршрут должна быть подписана очередь, которую слушает отправитель запроса, чтоб получить ответ или уведомление об ошибке - 'action' => 'string|required_without:error|regex:/[a-z]+.[a-z]+/ui' | формат поля action: 'псевдоним_класса.метод'
псевдоним_класса - ключ массива в конфиге laravel_rabbitmq.rpc - 'attributes' => 'array' | массив атрибутов [ключ => значение]
- 'error' => 'string|required_without:action' | ответ ошибкой на предыдущий запрос
- 'reply_for' => 'string|required_with:error' | ИД предыдущего запроса, обязателен, если отвечаем ошибкой
Подписчик RMQ получает сообщение, по полю action ищет нужный метод и выполняет его, подставляя в него аргументы
из поля attributes.
Все сообщения в RabbitMQ шифруются через Crypt::encryptString, таким образом во всех связанных сервисах
должен быть указан один и тот же APP_KEY.
Конфигурирование
В разделе queues задать все необходимые очереди, например:
В разделе consumers указать:
Добавить в конфиг laravel_rabbitmq блок rpc -> processors, в котором задать массив обработчиков в формате
<псевдоним> => <класс>, например:
Использование
Создаем обработчики
Создаем классы обработчиков и заполняем их в конфиг.
Каждому обработчику должен быть назначен уникальный псевдоним, который будет использоваться для вызова процедур.
Класс обработчика должен содержать публичные методы.
Каждый публичный метод может быть вызван через rpc.
Допускается использование статических методов.
Если запрошенный метод является статическим - он будет выполнен напрямую,
в качестве его аргументов будет распакован массив attributes из входящего запроса,
последним аргументом будет передан весь массив данных входящего запроса в виде именованного параметра $arData,
иначе будет создан экземпляр класса и выполнен запрошенный метод у объекта.
В конструктор класса будет передан весь массив данных входящего запроса в виде именованного параметра $arData.
Таким образом статический метод обработчика или конструктор класса обработчика (при его наличии) должны содержать обязательный аргумент
array $arData.
Отправка сообщения
Выполнение процедуры
Например, отправка команды на создание проекта:
где:
- 'projects.create' - экшн, projects - псевдоним класса, create - метод класса
- 'project' - аргумент для передачи в метод класса
- 'projectsData' - routing key, для отправки в очереди, подписанные на этот маршрут
Ответ с ошибкой
Запускаем слушатель rmq:
php artisan rabbitmq:consume <имя_сервиса> --time=-1 --messages=-1, где:
- --time=-1 - без ограничения по времени
- --messages=-1 - без ограничения по количеству сообщений
