Компонент Workflow
Компонент Workflow
Компонент Workflow надає інструменти для управління робочим процесом або кінцевою машиною.
Установка
1
$ composer require symfony/workflow
Note
Якщо ви встановлюєте цей компонент поза додатком Symfony, вам потрібно підключити
файл vendor/autoload.php
у вашому коді для включення механізму автозавантаження
класів, наданих Composer. Детальніше можна прочитати у цій статті.
Створення робочого процесу
Компонент Workflow надає вам обʼєктно-орієнтований спосіб для визначення процесу або життєвого циклу, через який проходить ваш обʼєкт. Кожний крок або етап у процесі називається місцем. Ви також визначаєте переходи, які опсиують дію для переміщення з одного місця в інше.
Набір місць та переходів створює визначення. Робочому процесу потрібно
Definition
і спосіб написання станів в обʼєкти (тобто, екземпляр
MarkingStoreInterface).
Розгляньте наступний приклад для посту блогу. Пост може мати один з багатьох передвизначених статусів (`draft`, `review`, `rejected`, `published`). У робочому процесі ці статуси називаються місцями. Ви можете визначати робочий процес так:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
use Symfony\Component\Workflow\DefinitionBuilder;
use Symfony\Component\Workflow\Transition;
use Symfony\Component\Workflow\Workflow;
use Symfony\Component\Workflow\MarkingStore\SingleStateMarkingStore;
$definitionBuilder = new DefinitionBuilder();
$definition = $definitionBuilder->addPlaces(['draft', 'review', 'rejected', 'published'])
// Переходи визначаються за допомогою унікального імені, початкового місця та місця призначення
->addTransition(new Transition('to_review', 'draft', 'review'))
->addTransition(new Transition('publish', 'review', 'published'))
->addTransition(new Transition('reject', 'review', 'rejected'))
->build()
;
$marking = new SingleStateMarkingStore('currentState');
$workflow = new Workflow($definition, $marking);
Workflow
тепер може допомогти вам вирішити, які дії дозволені у пості блогу,
в залежності від того, в якому місці він знаходиться. Він триматиме вашу логіку
в одному місці, а не розпорошуватиме її по всьому вашому додатку.
Коли ви визначаєте декілька робочих процесів, вам варто розглянути використання
Registry
, який є обʼєктом, що зберігає та надає доступ до різних робочих процесів.
Реєстр також допомагає вам вирішити, чи підтримує робочий процес обʼєкт, який ви
намагаєтесь використати з ним:
1 2 3 4 5 6 7 8 9 10 11
use Acme\Entity\BlogPost;
use Acme\Entity\Newsletter;
use Symfony\Component\Workflow\Registry;
use Symfony\Component\Workflow\SupportStrategy\InstanceOfSupportStrategy;
$blogPostWorkflow = ...;
$newsletterWorkflow = ...;
$registry = new Registry();
$registry->addWorkflow($blogPostWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
$registry->addWorkflow($newsletterWorkflow, new InstanceOfSupportStrategy(Newsletter::class));
Використання
Коли ви сконфігурували Registry
за допомогою вашого робочого процесу, ви можете
використати його таким чином:
1 2 3 4 5 6 7 8 9 10 11 12
// ...
// Вважайте, що $blogPost знаходиться у місці "draft" за замовчуванням
$blogPost = new BlogPost();
$workflow = $registry->get($blogPost);
$workflow->can($blogPost, 'publish'); // False
$workflow->can($blogPost, 'to_review'); // True
$workflow->apply($blogPost, 'to_review'); // $blogPost тепер у місці "reviewed"
$workflow->can($blogPost, 'publish'); // True
$workflow->getEnabledTransitions($blogPost); // $blogPost може виконати перехід "publish" або "reject"
Ініціалізація
Якщо властивість вашого обʼєкта - null
і ви хочете встановити її з
initial_marking
з конфігурації, ви можете викликати метод getMarking()
,
щоб ініціалізувати властивість обʼєкта:
1 2 3 4 5 6
// ...
$blogPost = new BlogPost();
$workflow = $registry->get($blogPost);
// initiate workflow
$workflow->getMarking($blogPost);
Дізнайтеся більше
Прочитайте більше про використання Компонента Workflow всередині додатку Symfony.