README.md

Related tickets:

• #203

Definitions

• Class
• Factory
• Value
• Alias
• Array (new)
• String/concat (new)?

Definition extensions

• Callback/Factory
• Array
• Class?
• Decorate (composition)?

For reference, in Symfony decoration is done that way: symfony/symfony#9003

Example

Base config:

<?php
return [
    Foo::class => object()
        ->constructorParam('param1', 0)
        ->constructorParam('param2', 1),
    
    'logger.handlers' => [
        link(StdOutHandler::class),
    ],
    
    // String
    'path.tmp' => '/tmp',
    'path.log' => string(link('path.tmp'), '/app.log'),
];

Factory extension:

<?php
return [
    Foo::class => extend()->factory(function (Foo $foo, ContainerInterface $container) {
        $foo->setStuff(true);
        return $foo;
    }),
];

Array extension:

<?php
return [
    'logger.handlers' => extend()->array([
        link(PaperTrailHandler::class),
    ]),
];

Class extension:

<?php
return [
    Foo::class => extend()->object()
        ->constructorParam('param2', 10),
];

What about chaining?

<?php
return [
    Foo::class => object(Bar::class)
        ->constructor(original(Foo::class)),
];

Or more simply (and probably saner):

<?php
return [
    Foo::class => object(),
    Bar::class => object()
        ->constructor(link(Foo::class)),
    SomeInterface::class => link(Bar::class),
];

test.md

1. Map an interface to an implementation

Psr\Log\LoggerInterface = Monolog\Logger

2. Map an interface to a PHP function that returns the instance

Psr\Log\LoggerInterface = function () {
    return new Monolog\Logger();
}

3. Define an array of objects

log_handlers = [
    Monolog\Handler\StreamHandler,
    Monolog\Handler\NewRelicHandler,
]

4. Add new entries to that array

log_handlers[] = Monolog\Handler\DebugBarHandler

4. Override an array entry

database[host] = 'localhost'

5. Decorate an object

Psr\Log\LoggerInterface = extend(Psr\Log\LoggerInterface, function (Psr\Log\LoggerInterface $logger) {
    return new LoggerDecorator($logger);
})

6. Define an object

My\Service = new('param1', 'param2')
    ->setFormatter(get(Formatter))

7. Extend an object definition

My\Service =