Download the PHP package elie29/zend-phpdi-config without Composer

zend-phpdi-config

🚀 Quick Start

✨ Features

• 🧩 PSR-11 compatible container configuration
• ⚡ Autowiring support
• 🔗 Service manager compatibility (Laminas/Mezzio)
• 💻 CLI tool for autowire entry management
• 🗃️ Cache and proxy support
• 🔄 Easy migration from other containers

📖 Introduction

zend-phpdi-config acts as a bridge to configure a PSR-11 compatible PHP-DI container using service manager configuration. It can be used with Laminas and Mezzio starting from v6.0.0

This library uses autowiring technique, cache compilation and cache definitions as defined in PHP-DI.

🛠️ Configuration

Service Manager Configuration

To get a configured PSR-11 PHP-DI container, do the following:

The dependencies sub associative array can contain the following keys:

• services: an associative array that maps a key to a specific service instance or service name.
• invokables: an associative array that map a key to a constructor-less service; i.e., for services that do not require arguments to the constructor. The key and service name usually are the same; if they are not, the key is treated as an alias. It could also be an array of services.
• autowires: an array of service with or without a constructor; PHP-DI offers an autowire technique that will scan the code and see what are the parameters needed in the constructors. Any aliases needed should be created in the aliases configuration.
• factories: an associative array that maps a service name to a factory class name, or any callable. Factory classes must be instantiable without arguments, and callable once instantiated (i.e., implement the __invoke() method).
• aliases: an associative array that maps an alias to a service name (or another alias).
• delegators: an associative array that maps service names to lists of delegator factory keys, see the Expressive delegators documentation for more details.

N.B.: The whole configuration -- unless dependencies -- is merged in a config key within the $container:

💻 CLI Usage

The CLI command add-autowires-entry creates the configuration file if it doesn't exist, otherwise it adds the entry to the autowires key.

Example of adding ConsoleHelper to a config.php:

You can also add this as a Composer script:

🐞 Troubleshooting / FAQ

Q: My service is not autowired. A: Ensure it is listed in the autowires array and all dependencies are available.

Q: The CLI tool fails with a permissions error. A: Make sure the config file directory is writable.

Q: How do I debug container errors? A: Check that all dependencies are correctly defined and that your factories do not throw exceptions.

Using with Expressive

Replace contents of config/container.php with the following:

Example of a ConfigProvider class

Where UserManager depends on Mailer as follow:

Switching back to another container

To switch back to another container is very easy:

1. Create your factories with __invoke function
2. Replace autowires key in ConfigProvider by factories key, then for each class name attach its correspondent factory.

PSR 11 and Interop\Container\ContainerInterface

V4.x supports as well Interop\Container\ContainerInterface

Migration guides

• Migration from 3.x to 4.0
• Migration from 4.x to 5.0: container-interop/container-interop was dropped in favor of PSR-11.

🤝 Contributing

See CONTRIBUTING.md for guidelines on how to contribute, run tests, and submit pull requests.

📄 License

This project is licensed under the MIT License. See LICENSE for details.