This library allows you to implement dependency injection design pattern in your WordPress plugin or theme. It provides a simple and easy-to-use interface to manage dependencies and hook callbacks.

Key Features

1. Reliable - Powered by PHP-DI, a mature and feature-rich dependency injection container.
2. Interoperable - Provides PSR-11 compliant container interface.
3. Easy to use - Reduces the boilerplate code required to manage dependencies and hook callbacks.
4. Customizable - Allows various configuration options to customize the container behavior.
5. Flexible - Enables advanced hook callback mechanisms.
6. Fast - Dependencies are resolved only when needed, and the container can be compiled for better performance.

Installation

You can install this package via composer:

[!TIP] We recommend using the automattic/jetpack-autoloader with this package to prevent autoloading issues.

Usage

Below is a simple example to demonstrate how to use this library in your plugin or theme.

Creating the Application and Container

You will need a class which will be used as the entry point for your plugin/theme. This class must have a #[Module] attribute to define the container configuration.

After defining the module, you can create the application using the xwp_create_app function.

Using handlers and callbacks

Handler is any class which is annotated with a #[Handler] attribute. Class methods can be annotated with #[Action] or #[Filter] attributes to define hook callbacks.

Examples

You can find the examples in the examples directory.

Documentation

For more information, please refer to the official documentation.