Download the PHP package comphp/di without Composer
On this page you can find all versions of the php package comphp/di. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package di
Short Description CommonPHP DependencyInjection is a simple, robust dependency injection container for PHP applications. It facilitates the dynamic creation of objects, invocation of methods, function calling, and property population.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package di
CommonPHP Dependency Injection
CommonPHP\DependencyInjection is a simple yet powerful dependency injection (DI) container for PHP applications, enabling the means to dynamically create new objects, invoke methods, call functions and populate properties without having to know the structure of the target directly.
Features
- Constructor and method injection: Instantiate classes and invoke methods with automatic resolution of dependencies.
- Value finder: A support class for the DI process that assists in discovering and managing parameter values during instantiation.
- Handling of circular dependencies: An instantiation stack to prevent issues caused by recursive dependency chains.
- Customizable parameter lookup: Enhance the default lookup process by adding custom lookup hooks.
- Populating object properties: Assign values to an object's properties, handling a variety of visibility and type scenarios.
- Exception handling: A series of specific exceptions to help troubleshoot issues related to DI and instantiation.
Requirements
The CommonPHP framework requires PHP 8.3 or newer. This library specifically has the following dependencies:
- PHP's built-in Reflection classes, which are used extensively for instantiating classes, invoking methods, and reading type information.
Installation
You can install CommonPHP\DependencyInjection using Composer:
Basic Usage
Instantiating Classes
The main component is the DependencyInjector class, which is responsible for injecting the passed parameters into a constructor, method or function.
Populating Object Properties
The DependencyInjector can also populate the properties of an object:
Custom Lookup Hooks
The ValueFinder class allows you to add custom lookup hooks:
Delegating Class Instantiation
For classes requiring specific instantiation logic, the DependencyInjector offers a delegate method. This method allows you to specify a custom callback for creating instances of a specific class, providing greater control over the object creation process.
Documentation
For more in-depth documentation, check out the Wiki.
API Reference
This is a high-level overview of the API. For detailed information about classes, methods, and properties, please refer to the source code and accompanying PHPDoc comments.
-
CommonPHP\DependencyInjection\DependencyInjector: The main class in the library. Provides methods for instantiating classes, invoking methods, calling functions, and populating properties with automatic dependency resolution.-
instantiate(string $class, array $params = []): object: Instantiates a class with the provided parameters. -
invoke($object, string $method, array $params = [], bool $publicOnly = true): mixed: Invokes a method on a given object with the provided parameters. -
call(callable $callable, array $params = []): mixed: Calls a function or closure with the provided parameters. populate(object $object, array $values, bool $publicOnly = true): void: Populates the properties of an object with the given values.
-
-
CommonPHP\DependencyInjection\Support\ValueFinder: A supporting class that assists in discovering and managing parameter values during instantiation.onLookup(callable $callback): void: Registers a callback function to be used during the lookup process.
Examples
Here are some examples of using CommonPHP\DependencyInjection. You can find the full source code for these examples in the examples directory of this repository.
-
Instantiate: This example shows how to instantiate a class using
DependencyInjector::instantiate(). -
Invoke: This example shows how to invoke a method using
DependencyInjector::invoke(). -
Call: This example shows how to call a function or closure using
DependencyInjector::call(). -
Populate: This example shows how to populate the properties of an object using
DependencyInjector::populate(). - Lookup Hooks: This example shows how to use a custom lookup hook with
ValueFinder::onLookup().
Contributing
Contributions are always welcome! Please read the contribution guidelines first.
Testing
This project uses PHPUnit for unit testing. Follow the instructions below to run the tests:
-
Ensure you have PHPUnit installed. If not, you can install it with Composer:
-
Navigate to the project's root directory.
-
Run the tests using the following command:
- If the tests are successful, you will see output similar to:
We recommend regularly running these tests during development to help catch any potential issues early. We also strive for a high level of test coverage, and additions to the codebase should ideally include corresponding tests.
For more detailed output or for integration into continuous integration (CI) systems, PHPUnit can generate a log file in a variety of formats. Check the PHPUnit documentation for more information.
License
This project is licensed under the MIT License. See the LICENSE.md file for details.
