PHPackages                             azim-ut/workflowapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. azim-ut/workflowapi

ActiveLibrary

azim-ut/workflowapi
===================

Base workflow API library

0.0.4(8mo ago)011Apache-2.0PHPPHP >=7.4

Since Sep 8Pushed 8mo agoCompare

[ Source](https://github.com/azim-ut/workFlowApi)[ Packagist](https://packagist.org/packages/azim-ut/workflowapi)[ RSS](/packages/azim-ut-workflowapi/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

Workflow API (PHP 7.4+)
=======================

[](#workflow-api-php-74)

**Workflow API** — это лёгкий и расширяемый инструмент для описания и исполнения бизнес-логики на основе JSON-конфигов.
Плагин позволяет вынести алгоритмы в декларативные схемы (например, `workflow.json`), а исполнение делегировать PHP-коду, сохраняя чистоту архитектуры.

---

Возможности
-----------

[](#возможности)

- Декларативное описание логики в JSON:
    - `payload` — входные данные, неизменные. Содержимое payload доступно только для чтения, payload можно передовать в качестве параметров в commands;
    - `state` — внутренние параметры, в state можно сохранять результаты исполнения commands или передавать в commands в качестве параметров на чтение/запись;
    - `commands` — зарегистрированные команды (методы, функции);
    - `route` — последовательность блоков (ACTION, IF\_ELSE, SWITCH, LOG и др.);
- Поддержка переменных `${payload.*}`, `${state.*}`;
- Выполнение кастомных команд, зарегистрированных через `setCommand()`;
- Лёгкая интеграция с сервисами и библиотеками;
- Логирование шагов исполнения.

---

Установка
---------

[](#установка)

```
composer require azim-ut/workflow-api
```

Пример использования
--------------------

[](#пример-использования)

```
$textService = new TextService();

$config = WorkflowService::builder()
    ->fromJsonFile(__DIR__ . '/conf/workflow.json')
    ->setCommand("getTextLength", [$textService, "getTextLength"])
    ->setCommand("matchPattern", [$textService, "matchAny"])
    ->setCommand("setStatus", [$textService, "setStatus"])
    ->build();

$payload = new stdClass();
$payload->text = "Hello world!";
$payload->patterns = ["ello", "earth"];

$result = WorkflowService::executor()->run($config, $payload);
```

Пример workflow.json
--------------------

[](#пример-workflowjson)

```
{
  "state": {"size": 0, "match": false, "status": "OPEN"},
  "commands": [
    "getTextLength",
    "matchPattern",
    "setStatus"
  ],
  "route": [
    {
      "id": 1,
      "type": "COMMAND",
      "command": "getTextLength ${payload.text} welcomeBtn closeBtn",
      "state": "size",
      "next": 2
    },
    {
      "id": 2,
      "type": "IF_ELSE",
      "condition": "${state.size} < 10",
      "yes": 6,
      "no": 3
    },
    {
      "id": 3,
      "type": "COMMAND",
      "command": "matchPattern ${payload.text} ${payload.patterns}",
      "state": "match",
      "next": 4
    },
    {
      "id": 4,
      "type": "IF_ELSE",
      "condition": "${state.match}",
      "yes": 6,
      "no": 7
    },

    {
      "id": 6,
      "type": "STATE",
      "target": "status",
      "val": "CLOSED",
      "next": 7
    },
    {
      "id": 7,
      "type": "COMMAND",
      "command": "setStatus ${payload.text} ${payload.status}",
      "next": 0
    }
  ],
  "log": []
}
```

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance61

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

4

Last Release

246d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/84817fb5d491f8133d4658b29ee8c02f6ffb1c1c2f7918abd267951ad57ab6fd?d=identicon)[azim-ut](/maintainers/azim-ut)

---

Top Contributors

[![azim-ut](https://avatars.githubusercontent.com/u/4218487?v=4)](https://github.com/azim-ut "azim-ut (22 commits)")

### Embed Badge

![Health badge](/badges/azim-ut-workflowapi/health.svg)

```
[![Health](https://phpackages.com/badges/azim-ut-workflowapi/health.svg)](https://phpackages.com/packages/azim-ut-workflowapi)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)