NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #600 most downloaded on Packagist
Provides tools for managing a workflow or finite state machine
Latest stable
v8.1.8
Last release 21 days ago
01 Nov 2026
Release timing varies
gaps range from 9 days to 4 months
Rarely documented
notes for 7 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
370 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
feature #66664 Deprecate ExpressionCacheWarmer and fail the warmup on invalid listed expressions instead (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v8.1.8...v8.2.0-BETA1)
command.invocation and migrate command examples (@nicolas-grekas)description argument to the AsWorkflow, Place and Transition attributes (@lyrixx)AsWorkflow, Place and Transition attributes (@tacman)lint:expressions command (@nicolas-grekas)# to define the initial marking (@lyrixx)ExpressionCacheWarmer and fail the warmup on invalid listed expressions instead (@nicolas-grekas)$context to WorkflowInterface::getMarking() (@nicolas-grekas)Your coding agent can read these notes before it upgrades. Set up the MCP server →
bug #66202 Escape the hash in Mermaid labels (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v8.1.0...v8.1.8)
Changelog (https://github.com/symfony/workflow/compare/v8.1.0-BETA3...v8.1.0) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v8.1.0-BETA3...v8.1.0)
bug #64280 Various fixes and hardenings (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v8.1.0-BETA1...v8.1.0-BETA3)
feature #63809 Add support for dumping listeners in Graphviz diagrams (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v8.0.9...v8.1.0-BETA1)
bug #63938 Fix HTML escaping in GraphvizDumper labels (@alexandre-daubois)
Changelog (https://github.com/symfony/workflow/compare/v8.0.6...v8.0.9)
GraphvizDumper labels (@alexandre-daubois)Changelog (https://github.com/symfony/workflow/compare/v8.0.7...v8.0.8) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v8.0.7...v8.0.8)
bug #63460 Implement missing reset() method in TraceableWorkflow (@santysisi)
Changelog (https://github.com/symfony/workflow/compare/v8.0.5...v8.0.6)
reset() method in TraceableWorkflow (@santysisi)WorkflowValidator (@yoeunes)Changelog (https://github.com/symfony/workflow/compare/v8.0.3...v8.0.4) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v8.0.3...v8.0.4)
bug symfony/symfony#62719 [Workflow] Fix empty string condition for place name (@mboelsterli)
Changelog (https://github.com/symfony/workflow/compare/v8.0.2...v8.0.3)
Add method getEnabledTransition() to WorkflowInterface
Add method getEnabledTransition() to WorkflowInterface
Add $nbToken argument to Marking::mark() and Marking::unmark()
Add $asArc argument to Transition::getFroms() and Transition::getTos()
Remove Event::getWorkflow() method
Before
use Symfony\Component\Workflow\Attribute\AsCompletedListener;
use Symfony\Component\Workflow\Event\CompletedEvent;
class MyListener
{
#[AsCompletedListener('my_workflow', 'to_state2')]
public function terminateOrder(CompletedEvent $event): void
{
$subject = $event->getSubject();
if ($event->getWorkflow()->can($subject, 'to_state3')) {
$event->getWorkflow()->apply($subject, 'to_state3');
}
}
}
After
use Symfony\Component\DependencyInjection\Attribute\Target;
use Symfony\Component\Workflow\Attribute\AsCompletedListener;
use Symfony\Component\Workflow\Event\CompletedEvent;
use Symfony\Component\Workflow\WorkflowInterface;
class MyListener
{
public function __construct(
#[Target('my_workflow')]
private readonly WorkflowInterface $workflow,
) {
}
#[AsCompletedListener('my_workflow', 'to_state2')]
public function terminateOrder(CompletedEvent $event): void
{
$subject = $event->getSubject();
if ($this->workflow->can($subject, 'to_state3')) {
$this->workflow->apply($subject, 'to_state3');
}
}
}
Or
use Symfony\Component\DependencyInjection\ServiceLocator;
use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
use Symfony\Component\Workflow\Attribute\AsTransitionListener;
use Symfony\Component\Workflow\Event\TransitionEvent;
class GenericListener
{
public function __construct(
#[AutowireLocator('workflow', 'name')]
private ServiceLocator $workflows
) {
}
#[AsTransitionListener]
public function doSomething(TransitionEvent $event): void
{
$workflow = $this->workflows->get($event->getWorkflowName());
}
}
bug symfony/symfony#62458 [Workflow] Fix MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)
Changelog (https://github.com/symfony/workflow/compare/v8.0.0-RC2...v8.0.0-RC3)
MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)Nothing published for this version
bug symfony/symfony#62211 [Workflow] State contamination due to class-based setter cache (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v8.0.0-BETA1...v8.0.0-BETA2)
feature symfony/symfony#61933 [Workflow] Move the dump command to the component (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.3.4...v8.0.0-BETA1)
BackedEnum in MethodMarkingStore (@tucksaun)bug #66202 Escape the hash in Mermaid labels (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v7.4.9...v7.4.20)
bug #63938 Fix HTML escaping in GraphvizDumper labels (@alexandre-daubois)
Changelog (https://github.com/symfony/workflow/compare/v7.4.6...v7.4.9)
GraphvizDumper labels (@alexandre-daubois)Changelog (https://github.com/symfony/workflow/compare/v7.4.7...v7.4.8) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.4.7...v7.4.8)
bug #63460 Implement missing reset() method in TraceableWorkflow (@santysisi)
Changelog (https://github.com/symfony/workflow/compare/v7.4.5...v7.4.6)
reset() method in TraceableWorkflow (@santysisi)WorkflowValidator (@yoeunes)Changelog (https://github.com/symfony/workflow/compare/v7.4.3...v7.4.4) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.4.3...v7.4.4)
bug symfony/symfony#62719 [Workflow] Fix empty string condition for place name (@mboelsterli)
Changelog (https://github.com/symfony/workflow/compare/v7.4.2...v7.4.3)
Changelog (https://github.com/symfony/workflow/compare/v7.4.0-RC3...v7.4.0) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.4.0-RC3...v7.4.0)
BackedEnum in MethodMarkingStorebug symfony/symfony#62458 [Workflow] Fix MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)
Changelog (https://github.com/symfony/workflow/compare/v7.4.0-RC2...v7.4.0-RC3)
MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)Changelog (https://github.com/symfony/workflow/compare/v7.4.0-BETA2...v7.4.0-RC1) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.4.0-BETA2...v7.4.0-RC1)
bug symfony/symfony#62211 [Workflow] State contamination due to class-based setter cache (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v7.4.0-BETA1...v7.4.0-BETA2)
feature symfony/symfony#61933 [Workflow] Move the dump command to the component (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.3.4...v7.4.0-BETA1)
BackedEnum in MethodMarkingStore (@tucksaun)Changelog (https://github.com/symfony/workflow/compare/v7.3.9...v7.3.10) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.3.9...v7.3.10)
bug symfony/symfony#62458 [Workflow] Fix MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)
Changelog (https://github.com/symfony/workflow/compare/v7.3.7...v7.3.8)
MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)bug symfony/symfony#61912 [FrameworkBundle] Fix support of dumping workflow when workflow is decorated by TraceableWorkflow (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.3.4...v7.3.5)
Changelog (https://github.com/symfony/workflow/compare/v7.3.1...v7.3.2) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.3.1...v7.3.2)
Changelog (https://github.com/symfony/workflow/compare/v7.3.0-RC1...v7.3.0) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.3.0-RC1...v7.3.0)
Changelog (https://github.com/symfony/workflow/compare/v7.3.0-BETA2...v7.3.0-RC1) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.3.0-BETA2...v7.3.0-RC1)
feature symfony/symfony#54276 [Workflow] Add support for executing custom workflow definition validators during the container compilation (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.3.0-BETA1...v7.3.0-BETA2)
feature symfony/symfony#60195 [Workflow] Deprecate Event::getWorkflow() method (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.2.6...v7.3.0-BETA1)
Event::getWorkflow() method (@lyrixx)Changelog (https://github.com/symfony/workflow/compare/v7.2.8...v7.2.9) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.2.8...v7.2.9)
bug symfony/symfony#60194 [Workflow] Fix dispatch of entered event when the subject is already in this marking (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.2.5...v7.2.6)
Changelog (https://github.com/symfony/workflow/compare/v7.2.0-RC1...v7.2.0) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.2.0-RC1...v7.2.0)
Nothing published for this version
Changelog (https://github.com/symfony/workflow/compare/v7.1.6...v7.2.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.1.6...v7.2.0-BETA1)
Changelog (https://github.com/symfony/workflow/compare/v7.1.5...v7.1.6) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.1.5...v7.1.6)
Changelog (https://github.com/symfony/workflow/compare/v7.1.0...v7.1.1) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.1.0...v7.1.1)
Changelog (https://github.com/symfony/workflow/compare/v7.1.0-RC1...v7.1.0) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.1.0-RC1...v7.1.0)
getEnabledTransition() to WorkflowInterfacegetName() in event classes to build event names in subscribersChangelog (https://github.com/symfony/workflow/compare/v7.1.0-BETA1...v7.1.0-RC1) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.1.0-BETA1...v7.1.0-RC1)
feature symfony/symfony#54344 [Workflow] Add EventNameTrait to compute event name strings in subscribers (@squrious)
Changelog (https://github.com/symfony/workflow/compare/v7.0.7...v7.1.0-BETA1)
getEnabledTransition() method annotation to WorkflowInterface (@alexandre-daubois)Changelog (https://github.com/symfony/workflow/compare/v7.0.7...v7.0.8) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.7...v7.0.8)
Changelog (https://github.com/symfony/workflow/compare/v7.0.6...v7.0.7) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.6...v7.0.7)
bug symfony/symfony#53865 [Workflow]Fix Marking when it must contains more than one tokens (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v7.0.5...v7.0.6)
Changelog (https://github.com/symfony/workflow/compare/v7.0.2...v7.0.3) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.2...v7.0.3)
Changelog (https://github.com/symfony/workflow/compare/v7.0.1...v7.0.2) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.1...v7.0.2)
bug symfony/symfony#52814 [Workflow] Add getEnabledTransition() to TraceableWorkflow (@alexandre-daubois)
Changelog (https://github.com/symfony/workflow/compare/v7.0.0...v7.0.1)
getEnabledTransition() to TraceableWorkflow (@alexandre-daubois)Changelog (https://github.com/symfony/workflow/compare/v7.0.0-RC2...v7.0.0) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.0-RC2...v7.0.0)
Definition::setInitialPlaces()GuardEvent::getContext() method has been removed. Method was not supposed to be called within guard event listeners as it always returned an empty array anyway.GuardEvent::getContext() method without replacementChangelog (https://github.com/symfony/workflow/compare/v7.0.0-RC1...v7.0.0-RC2) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.0-RC1...v7.0.0-RC2)
Changelog (https://github.com/symfony/workflow/compare/v7.0.0-BETA3...v7.0.0-RC1) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.0-BETA3...v7.0.0-RC1)
Changelog (https://github.com/symfony/workflow/compare/v7.0.0-BETA1...v7.0.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v7.0.0-BETA1...v7.0.0-BETA2)
feature symfony/symfony#51976 [Workflow] Revert deprecation about Registry (@lyrixx)
Changelog (https://github.com/symfony/workflow/compare/v6.3.6...v7.0.0-BETA1)
TraceableWorkflow (@lyrixx)GuardEvent::getContext() method without replacement (@alexandre-daubois)GuardEvent::getContext() method and add HasContextTrait trait (@hhamon)GuardEvent::getContext method (@hhamon)GraphvizDumper (@Louis-Proffit)bug #66202 Escape the hash in Mermaid labels (@nicolas-grekas)
Changelog (https://github.com/symfony/workflow/compare/v6.4.37...v6.4.47)
bug #63938 Fix HTML escaping in GraphvizDumper labels (@alexandre-daubois)
Changelog (https://github.com/symfony/workflow/compare/v6.4.34...v6.4.37)
GraphvizDumper labels (@alexandre-daubois)bug #63460 Implement missing reset() method in TraceableWorkflow (@santysisi)
Changelog (https://github.com/symfony/workflow/compare/v6.4.33...v6.4.34)
reset() method in TraceableWorkflow (@santysisi)Changelog (https://github.com/symfony/workflow/compare/v6.4.31...v6.4.32) * no significant changes
Changelog (https://github.com/symfony/workflow/compare/v6.4.31...v6.4.32)
bug symfony/symfony#62458 [Workflow] Fix MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)
Changelog (https://github.com/symfony/workflow/compare/v6.4.29...v6.4.30)
MethodMarkingStore crash with inherited uninitialized properties (@yoeunes)One column per quarter.