GacelaBuild modular PHP applications

Split your application into modules that talk through one door. Everything behind it stays private.

Core concepts

The anatomy of a module

Every module exposes the same four classes, so any module in any Gacela project reads the same way. Other modules only ever call the Facade.

Facade.php

Facade

The entry point of the module, and the only class other modules call.

Factory.php

Factory

Creates the module's internal services and wires its intra-dependencies.

Provider.php

Provider

Resolves what the module needs from outside: its extra-dependencies.

Config.php

Config

Reads the project's config files from one predictable place.

Quickstart

A module in three files

This is the whole ceremony: a Facade in front, a Factory wiring a service behind it, and one bootstrap call at your entry point. The Facade resolves its sibling Factory automatically.

Facade.phpFactory.phpGreeter.phpexample.php

php

namespace Module;

use Gacela\Framework\AbstractFacade;

/**
 * @method Factory getFactory()
 */
final class Facade extends AbstractFacade
{
    public function greet(string $name): string
    {
        return $this->getFactory()
            ->createGreeter()
            ->greet($name);
    }
}

php

namespace Module;

use Gacela\Framework\AbstractFactory;
use Module\Service\Greeter;

final class Factory extends AbstractFactory
{
    public function createGreeter(): Greeter
    {
        return new Greeter();
    }
}

php

namespace Module\Service;

final class Greeter
{
    public function greet(string $name): string
    {
        return "Hi, $name!";
    }
}

php

use Gacela\Framework\Gacela;
use Module\Facade;

require __DIR__ . '/vendor/autoload.php';

Gacela::bootstrap(__DIR__);

$facade = new Facade();
echo $facade->greet('Alice'); # Hi, Alice!

Features

Beyond the basics

Container DIContextual bindings, aliases, protected & factory services CachingThree layers: framework resolution, cacheable methods, file cache Toolingcache:warm, doctor, debug:dependencies, profile:report Health checksPer-module status for the doctor CLI and HTTP endpoints Inject attributeOpt-in #[Inject] constructor injection with implementation overrides Provides attributeDeclarative #[Provides] for provider service registration

Get started

Start your first module

bash

composer require gacela-project/gacela

Read the quickstart · See who uses Gacela