Getting Started

Now that you understand the philosophy, let’s put it into practice.

Requirements

• PHP 8.4+
• Composer

Installation

git clone https://github.com/be-framework/app my-project
cd my-project
rm -rf .git
composer install

Run the Example

php bin/app.php

Output:

Hello World

That’s it! Let’s look at the code.

Project Structure

src/
├── Input/
│   └── HelloInput.php      # Starting point
├── Final/
│   └── Hello.php           # Destination
├── Reason/
│   └── Greeting.php        # Transcendent capability
├── Semantic/
│   └── Name.php            # Semantic variables
├── Exception/
│   └── EmptyNameException.php
└── Module/
    └── AppModule.php       # DI configuration

The Code

Input Class

#[Be([Hello::class])]
final readonly class HelloInput
{
    public function __construct(
        public string $name
    ) {}
}

The #[Be] attribute declares the destiny—what this input will become.

Final Class

final readonly class Hello
{
    public string $greeting;

    public function __construct(
        #[Input] string $name,
        #[Inject] Greeting $greeting,
    ) {
        $this->greeting = "{$greeting->greeting} {$name}";
    }
}

• #[Input] receives data from the previous stage (HelloInput)
• #[Inject] receives Transcendence (capability from outside)

Reason Class

final class Greeting
{
    public string $greeting = 'Hello';
}

The Greeting provides the transcendent capability—the power to greet.

Executing Metamorphosis

$injector = new Injector(new AppModule());
$becoming = new Becoming($injector, 'Be\\App\\Semantic');

$input = new HelloInput('World');
$hello = $becoming($input);

echo $hello->greeting;  // "Hello World"

What Just Happened?

HelloInput('World')
    ↓ Becoming executes
Hello (with Greeting injected)
    → "Hello World"

The input didn’t “do” anything—it became Hello through metamorphosis.

Try Semantic Validation

Edit bin/app.php to pass an empty name:

$input = new HelloInput('');

Run again:

php bin/app.php

You’ll see an error message because Semantic/Name.php validates that name cannot be empty.

Key Concepts Demonstrated

Next Steps

Ready for a more complete example with Being classes and branching? Continue to Tutorial →

Or revisit the concepts:

• Input Classes - Starting points
• Final Objects - Destinations
• Semantic Variables - Domain ontology