makomweb/tactix

Tooling for tactical domain driven design

v0.1.4 2026-01-15 13:00 UTC

Requires

• php: ^8.2
• nikic/php-parser: ^5.7
• xmolecules/phpmolecules: ^0.2.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.92
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.5

MIT

• Martin Komischke

README

Tactical DDD, simplified for PHP: tag your classes (via PHP attributes) and validate missing tags + forbidden relations.

Installation

composer require --dev makomweb/tactix

Requirements:

• PHP ^8.2
• your source code being tagged with PHP Molecules

Usage

1. Tag your classes

• install the tags package from PHP Molecules as a regular dependeny via:

composer require xmolecules/phpmolecules

• tag your classes with the available attributes:

use PHPMolecules\DDD\Attribute\AggregateRoot;
use PHPMolecules\DDD\Attribute\Entity;
use PHPMolecules\DDD\Attribute\ValueObject;
use PHPMolecules\DDD\Attribute\Service;
use PHPMolecules\DDD\Attribute\Factory;
use PHPMolecules\DDD\Attribute\Repository;

#[Entity]
final class User {}

2. Check your classes or folders

use Tactix\Check;

Check::className(User::class);
Check::folder(__DIR__.'/src');

Check throws on violations:

• Tactix\ClassViolationException
• Tactix\FolderViolationException

Both exceptions contain a $violations property of type array<Tactix\Violation> to get further details about wether there are missing tags, ambiguity or forbidden relations.

Forbidden relations

Tactix includes a small built-in blacklist (see Tactix\Forbidden) and reports violations as:

(MyValueObject)-[consumes]->(MyEntity) is a forbidden relation! ❌