Get support for yiisoft/factory

If you're new to LTH, please see our FAQ for more information on what it is we do.

Support Options

Unfortunately, there are currently no active helpers for this repository on the platform. Until they become available, we reccomend the following actions:

View Open Issues

Take a look to see if anyone else has experienced the same issue as you and if they managed to solve it.

Open an Issue

Make sure to read any relevant guidelines for opening issues on this repo before posting a new issue.

Sponsor directly

Check out the page and see if there are any options to sponsor this project or it's developers directly.

yiisoft/factory

Latest Stable Version Total Downloads Build Status Scrutinizer Code Quality Code Coverage Mutation testing badge static analysis type-coverage

This package provides abstract object factory allowing to create objects by given definition with dependencies resolved by a PSR-11 container.

Requirements

  • PHP 8.0 or higher.

Installation

The package could be installed with Composer:

composer require yiisoft/factory

General usage

The factory is useful if you need to create objects using definition syntax and/or want to configure defaults for objects created.

$container = new PSR11DependencyInjectionContainer();
$factoryConfig = [
    EngineInterface::class => [
        'class' => EngineMarkOne::class,
        '__construct()' => [
            'power' => 42,
        ],
    ]
];

$factory = new Factory($container, $factoryConfig);

$one = $factory->create(EngineInterface::class);
$two = $factory->create([
    'class' => EngineInterface::class,
    '__construct()' => [
        'power' => 146,
    ],
]);

In the code above we define factory config specifying that when we need EngineInterface, an instance of EngineMarkOne will be created with power constructor argument equals to 42. We also specify that all the dependencies requested by the object created should be resolved by PSR11DependencyInjectionContainer.

First call to create() uses default configuration of EngineInterface as is. Second call specifies custom configuration for power constructor argument. In this case, configuration specified is merged with default configuration overriding its keys when the key name is the same.

Tuning for production

By default, the factory validates definitions right when they are set. In production environment, it makes sense to turn it off by passing false as a third constructor argument:

$factory = new Factory($container, $factoryConfig, false);

Documentation

If you need help or have a question, the Yii Forum is a good place for that. You may also check out other Yii Community Resources.

License

The Yii Factory is free software. It is released under the terms of the BSD License. Please see LICENSE for more information.

Maintained by Yii Software.

Support the project

Open Collective

Follow updates

Official website Twitter Telegram Facebook Slack

Our Mission

We want to make open source more sustainable. The entire platform was born from this and everything we do is in aid of this.

Interesting Articles

Thank you for checking out LiveTechHelper |
2025 © lth-dev incorporated

p-e622a1a2