gacela-project/gacela

Gacela helps you separate your project into modules

1.13.0 2026-04-15 06:41 UTC

Requires

• php: >=8.1
• gacela-project/container: ^0.8

Requires (Dev)

• ergebnis/composer-normalize: ^2.50
• friendsofphp/php-cs-fixer: ^3.95
• infection/infection: ^0.29
• phpbench/phpbench: ^1.4
• phpmetrics/phpmetrics: ^2.9
• phpstan/phpstan: ^1.12
• phpstan/phpstan-strict-rules: ^1.6
• phpunit/phpunit: ^10.5
• psalm/plugin-phpunit: ^0.19.5
• rector/rector: ^1.2
• symfony/console: ^6.4
• symfony/var-dumper: ^6.4
• vimeo/psalm: ^6.16

Suggests

• gacela-project/gacela-env-config-reader: Allows to read .env config files
• gacela-project/gacela-yaml-config-reader: Allows to read yml/yaml config files
• gacela-project/phpstan-extension: A set of phpstan rules for Gacela
• symfony/console: Allows to use vendor/bin/gacela script

MIT

• Jose Maria Valera Reales
• Jesus Valera Reales

• framework
• php
• modular
• kernel

README

Gacela — build modular PHP applications

Gacela normalizes module boundaries so parts of your application communicate through a single entry point, without leaking internals.

Each module exposes four classes:

• Facade — public API, the only way in
• Factory — creates internal services
• Provider — wires external dependencies
• Config — reads project config

Installation

composer require gacela-project/gacela

Module structure

app/
├── gacela.php
├── config/
└── src/
    └── ModuleA/
        ├── Facade.php
        ├── Factory.php
        ├── Provider.php
        └── Config.php

Documentation

• Getting started
• Container configuration
• Static analysis (PHPStan / Psalm)
• Module health checks
• Opcache preload
• Full reference: gacela-project.com
• Examples: gacela-example

Contributing

Report issues, share ideas, or open a pull request.

Inspired by Spryker.