Компонент Рабочий процесс¶

Установка¶

Вы можете установить компонент 2 разными способами:

• Установить его через Composer (symfony/workflow на Packagist);
• Использовать официальное хранилище Git (https://github.com/symfony/workflow).

Then, require the vendor/autoload.php file to enable the autoloading mechanism provided by Composer. Otherwise, your application won't be able to find the classes of this Symfony component.

Создание рабочего процесса¶

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

Набор мест и переходов создаёт определение. Рабочему процессу нужно 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;

$definition = new 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

use Symfony\Component\Workflow\Registry;
use Acme\Entity\BlogPost;
use Acme\Entity\Newsletter;

$blogWorkflow = ...
$newsletterWorkflow = ...

$registry = new Registry();
$registry->add($blogWorkflow, BlogPost::class);
$registry->add($newsletterWorkflow, Newsletter::class);

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

Когда вы сконфигурировали Registry с помощью вашего рабочего процесса, вы можете использовать его таким образом:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// ...
$post = new BlogPost();
$workflow = $registry->get($post);

$workflow->can($post, 'publish'); // False
$workflow->can($post, 'to_review'); // True

$workflow->apply($post, 'to_review');
$workflow->can($post, 'publish'); // True
$workflow->getEnabledTransitions($post); // ['publish', 'reject']

Узнать больше¶