Команды и задания Laravel

Ответ 1

Я вижу эти "объекты" следующим образом: (Я добавил некоторые примеры кода из одного из моих побочных проектов)

Консоль

Вещи, которые я хочу выполнить из командной строки (Как вы упомянули в своем примере с "Удалить файлы старше x" ). Но дело в том, что вы можете извлечь бизнес-логику из нее в команду .

Пример: консольная команда с огнем команды для извлечения изображений из Imgur. Класс FetchImages содержит фактическую бизнес-логику выборки изображений.

Command

Класс, содержащий фактическую логику. Вы также можете вызвать эту команду из своего приложения с помощью app()->make(Command::class)->handle().

Пример: Команда, упомянутая в примере 1. Содержит логику, которая фактически вызывает API для Imgur и обрабатывает возвращенные данные.

Работа

Я сделал это приложение с Laravel 5.0, поэтому jobs не было тогда. Но, как я вижу, Джобс как команды, но они поставлены в очередь и могут быть отправлены. (Как вы могли видеть в этих примерах, эти команды реализуют ваши упомянутые интерфейсы SelfHandling и ShouldBeQueued).

Я считаю себя опытным разработчиком Laravel, но те изменения в Commands и jobs довольно трудно понять.

EDIT: Из документов Laravel:

Каталог приложений/команд был переименован в приложение/Джобс. Однако вам не нужно перемещать все свои команды в новое место, и вы можете продолжать использовать команду make: command and handler: command Artisan для генерации ваших классов.

Аналогично, каталог app/Handlers был переименован в приложение /Listeners и теперь содержит только прослушиватели событий. Однако вам не требуется перемещать или переименовывать существующие обработчики команд и событий, и вы можете продолжать использовать команду обработчик: event для генерации обработчиков событий.

Предоставляя обратную совместимость для структуры папок Laravel 5.0, вы можете обновлять свои приложения до Laravel 5.1 и медленно обновлять свои события и команды до своих новых местоположений, когда это удобно для вас или вашей команды.

Ответ 2

Консольные команды

В течение некоторого времени у Laravel были консольные команды. Они в основном неизменны и работают так, как они всегда есть. Проще говоря, они являются эквивалентом маршрутов для командной строки - точки входа в приложение. Они никоим образом не связаны с...

Командная шина

В Laravel 5.0 реализована реализация команды Command Bus pattern - Command Bus Commands. (Я считаю, что они были переименованы в "Джобс" из-за возникающей путаницы между ними и командами CLI).

Командная шина как две части - объект, который представляет собой команду, которая должна быть выполнена, с любыми и всеми данными, которые ему нужны (задание), и класс для выполнения команды (обработчик).

Обработчик

В laravel вы можете объявить задание самостоятельной обработкой, то есть иметь сам метод дескриптора.

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

app('Illuminate\Bus\Dispatcher')->maps(['Job' => 'Handler']);

где Job - это имя класса для задания, а Handler - это имя класса для обработчика.

Каталог обработчиков в laravel 5.0 был способом неявного объявления этих отношений (т.е. EmailCommand в папке команд имело бы EmailCommandHandler в папке обработчиков).

Отправка команды

Вы можете использовать следующую команду для отправки команды.

app('Illuminate\Bus\Dispatcher')->dispatch(new EmailPersonCommand('[email protected]', $otherdata));

Очередь

Задания, по умолчанию, будут запускаться, как только они будут вызваны (или отправлены). Установка их как ShouldQueue всегда будет передавать их в очередь при отправке.

Если вы хотите периодически запускать их синхронно и асинхронно в другое время, вы можете вызвать $dispatcher->dispatchToQueue($job), когда вы хотите, чтобы они были в очереди. Это все, что происходит внутри, когда вы передаете задание ShouldQueue на ->dispatch().

edit: To Queuing (или нет)

Я только что посмотрел на диспетчера. Метод dispatch проверяет, является ли команда ShouldQueue, и либо переводит ее на dispatchToQueue, либо dispatchNow. Вы можете вызвать любой из этих методов непосредственно вместо dispatch с помощью вашей команды, если вы хотите переопределить поведение по умолчанию.

Итак, в вашем случае, в зависимости от того, что "поведение по умолчанию" вашего задания (т.е. будет ли оно обычно поставлено в очередь?): - используйте ShouldQueue и используйте dispatchNow в команде CLI. - не иметь его ShouldQueue и использовать dispatchToQueue, где вы вызываете его в своем коде.

Из его звуков я бы сделал первый.

Ответ 3

Просто добавление к фактическим ответам.

Работы в Laravel >= 5.1 являются командами Bus в Laravel 5.0.

Это изменение имени только из-за путаницы между Console\Commands (команды, запускаемые с консоли) и Command Bus (содержащие Commands) для задач приложения.

Нельзя смешивать:

• Command Bus: используется для "инкапсуляции задач вашего приложения" (из larvel 5.0 doc), который теперь переименован в Jobs
• Console\Commands: используется для "Artisan [...] интерфейса командной строки, включенного в Laravel" (из laravel 5.1 docs), который не изменяется в Laravel с 4.x