https://github.com/johnnymast/logichain
Declarative workflows for real‑world PHP applications. Predictable, testable, and built for teams that value maintainable code.
https://github.com/johnnymast/logichain
automation library logic php pipeline workflow
Last synced: 3 months ago
JSON representation
Declarative workflows for real‑world PHP applications. Predictable, testable, and built for teams that value maintainable code.
- Host: GitHub
- URL: https://github.com/johnnymast/logichain
- Owner: johnnymast
- License: apache-2.0
- Created: 2026-03-05T08:45:26.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-03-27T17:37:12.000Z (3 months ago)
- Last Synced: 2026-03-28T01:37:59.615Z (3 months ago)
- Topics: automation, library, logic, php, pipeline, workflow
- Language: PHP
- Homepage:
- Size: 85.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Notice: NOTICE
Awesome Lists containing this project
README
[](https://github.com/johnnymast/workflow-php/actions/workflows/tests.yml)
[](https://www.apache.org/licenses/LICENSE-2.0)
# LogicChain
Workflow is built on a simple belief: complex logic shouldn’t feel complex.
This library gives you a clean, expressive way to structure multi‑step processes without drowning in conditionals, flags, or scattered service calls. Every workflow becomes a clear, linear story — one step at a time — with predictable behavior and a result you can always trust.
Whether you’re transforming data, orchestrating services, or coordinating real‑world business operations, Workflow helps you keep your code honest and your intent visible. No magic, no hidden state, no surprises. Just a lightweight pipeline that does exactly what you tell it to do.
It’s designed for developers who care about clarity.
For teams that value maintainability.
And for projects where the flow of logic matters just as much as the outcome.
If you’ve ever wished your application logic read more like a narrative and less like a maze, you’ll feel right at home here.
Large features that once required hundreds or even thousands of lines of orchestration logic can now be expressed as a simple, readable pipeline:
```php
use JohnnyMast\LogicChain\Workflow;
use Examples\Invokables\ValidateOrder;
use Examples\Invokables\CreateOrder;
use Examples\Invokables\StoreOrder;
use Examples\Invokables\SendOrderEmail;
$workflow = (new Workflow())
->add(new ValidateOrder())
->add(new CreateOrder())
->add(new StoreOrder())
->add(new SendOrderEmail())
->success(fn($r) => print "Order completed\n")
->failed(fn($r) => print "Order failed: {$r->context->error}\n");
$result = $workflow->run([
'customer' => 'john@example.com',
'items' => ['sku-123', 'sku-456'],
]);
```
That’s the entire flow — end to end.
No scattered service calls, no deeply nested conditionals, no hidden state.
Just a clean sequence of steps that tells the story of what your application is doing.
---
## Installation
Install LogicChain via Composer:
```bash
composer require johnnymast/logichain
```
After installation, all classes are available under the namespace:
```php
JohnnyMast\LogicChain
```
---
## Examples & Use Cases
LogicChain includes a collection of practical examples that demonstrate how to build and structure chains for different scenarios.
If you want to explore real‑world use cases or see how to apply the library in your own projects, check the `examples/` directory in the project root.
The examples show:
- how to build a simple chain
- how to pass context between steps
- how to handle success and failure callbacks
- how to structure reusable step classes
- how to orchestrate multi‑step business logic
Exploring the examples is the quickest way to understand how LogicChain works in real applications.
---
## Apache 2.0 License
LogicChain is licensed under the Apache License, Version 2.0 (Apache-2.0).
© 2026 Johnny Mast — mastjohnny@gmail.com
You may use this project in commercial and private applications under the terms of the Apache 2.0 license.
See the full license in the [LICENSE.md](LICENSE.md) file.
Additional project notices can be found in the [NOTICE](NOTICE) file.