PHPackages                             dmstr/flowable-bundle - 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. [API Development](/categories/api)
4. /
5. dmstr/flowable-bundle

ActiveSymfony-bundle[API Development](/categories/api)

dmstr/flowable-bundle
=====================

Flowable BPMN engine pass-through resources, HTTP client and CLI for API Platform / Symfony.

0.1.0(today)00MITPHPPHP >=8.4

Since Jul 1Pushed todayCompare

[ Source](https://github.com/dmstr/flowable-bundle)[ Packagist](https://packagist.org/packages/dmstr/flowable-bundle)[ RSS](/packages/dmstr-flowable-bundle/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (17)Versions (2)Used By (0)

dmstr/flowable-bundle
=====================

[](#dmstrflowable-bundle)

Reusable Symfony bundle that exposes a [Flowable](https://www.flowable.com/)BPMN engine as **Doctrine-less [API Platform](https://api-platform.com/)pass-through resources**, a per-request HTTP client and matching `flowable:*`CLI commands.

The bundle owns no database tables: every resource reads from and writes to a remote Flowable REST engine at request time. Connection details (base URL and credentials) are resolved per request from an `ApiConfiguration` of type `flowable` (provided by `dmstr/api-configuration-bundle`).

Requirements
------------

[](#requirements)

- PHP >= 8.4
- Symfony 7
- API Platform 4
- A reachable Flowable REST engine (`flowable-rest`)

Installation
------------

[](#installation)

```
composer require dmstr/flowable-bundle
```

If you do not use a Symfony Flex recipe that registers the bundle, add it to `config/bundles.php`:

```
return [
    // ...
    Dmstr\Flowable\FlowableBundle::class => ['all' => true],
];
```

The bundle is self-wiring: it ships its own service definitions (`FlowableBundle::loadExtension()`), registers a dedicated `flowable` Monolog channel and needs no entry in the application's `services.yaml`. API Platform discovers the resource classes automatically from `src/ApiResource`.

Configuration
-------------

[](#configuration)

Create an `ApiConfiguration` of type `flowable`. Its `configJson` is validated against [`schema.json`](schema.json):

```
{
    "base_url": "http://flowable-rest:8080/flowable-rest/service",
    "auth_type": "basic",
    "username": "rest-admin",
    "password": "..."
}
```

`auth_type` is either `basic` (requires `username` + `password`) or `bearer`(requires `token`).

API resources
-------------

[](#api-resources)

All resources are served under `/api/flowable/*`:

ResourceNotable operations`FlowDeployment``GET /deployments`, `GET /deployments/{id}`, `POST /deployments/upload`, `DELETE``FlowProcessDefinition``GET /process_definitions`, `POST /process_definitions/{id}/start``FlowProcessInstance``GET /process_instances`, `POST /process_instances`, `DELETE``FlowTask``GET /tasks`, `POST /tasks/{id}/complete`, `GET /tasks/{id}/input_schema``FlowExecution``GET /executions`, `POST /executions/{id}/trigger``FlowHistoric*`read-only history: activities, process instances, tasks, variablesThe `input_schema` endpoint returns the per-task input JSON-Schema, resolved at runtime from either an authored `.schema.json` deployment resource or by converting inline Flowable form-data — via the pluggable `flowable.task_form_source` chain.

CLI
---

[](#cli)

Every REST operation has a matching command; command IDs mirror the resource URLs:

```
flowable:health
flowable:deployments                 flowable:deployments:upload
flowable:process-definitions
flowable:process-instances           flowable:process-instances:create
flowable:tasks                       flowable:tasks:complete
flowable:executions                  flowable:executions:trigger

```

Security
--------

[](#security)

Reading is open to any authenticated user. Starting, triggering and completing (all write operations) require `ROLE_FLOWABLE_ADMIN`. The acting user is taken from the authenticated identity (JWT `sub`) and propagated to Flowable — see [`docs/tenant-and-user.md`](docs/tenant-and-user.md).

Documentation
-------------

[](#documentation)

- [`docs/walkthrough-vacation-request.md`](docs/walkthrough-vacation-request.md)— end-to-end walkthrough of a human-task process.
- [`docs/tenant-and-user.md`](docs/tenant-and-user.md) — tenant and acting-user model.

License
-------

[](#license)

[MIT](LICENSE) © diemeisterei GmbH

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3b4ab2b6685ec71887908ec8cff261a16cd5bb24c69bb8ab52840e220f175f9d?d=identicon)[schmunk](/maintainers/schmunk)

---

Top Contributors

[![schmunk42](https://avatars.githubusercontent.com/u/649031?v=4)](https://github.com/schmunk42 "schmunk42 (1 commits)")

---

Tags

symfonyworkflowapi-platformbpmnflowableprocess-engine

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dmstr-flowable-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/dmstr-flowable-bundle/health.svg)](https://phpackages.com/packages/dmstr-flowable-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M384](/packages/easycorp-easyadmin-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M726](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M199](/packages/sulu-sulu)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M555](/packages/shopware-core)[oro/platform

Business Application Platform (BAP)

645143.5k114](/packages/oro-platform)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k59](/packages/open-dxp-opendxp)

PHPackages © 2026

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