This article discusses how to build a simple dependency injection container (DI container) PHP package. All code in the article, including PHPDoc annotations and unit tests (100% code coverage), has been uploaded to the GitHub repository and listed on Packagist.
Key points:
- Building DI containers helps developers understand the basic principles of dependency injection and the working mechanism of containers.
- DI containers have two main functions: "dependency injection" and "container". It needs to be able to instantiate and include services using constructor injection or setter injection methods.
- Symfony Dependency Injection Container can be used as a reference for creating custom containers. It divides container configuration into parameters and services, allowing secure storage of application keys.
- Creating a DI container involves creating a project directory, creating a
composer.json
file, and implementing a container interoperability interface. It also involves creating exceptions and reference classes. - Container class needs to contain methods for retrieving services, checking whether services have been defined, parsing parameters, and initializing services. It should also have a protection mechanism to prevent circular references.
Plan our dependency injection container
First, we split the "dependency injection container" into two roles: "dependency injection" and "container".
The two most commonly used methods of dependency injection are constructor injection and setter injection, that is, passing class dependencies through constructor parameters or method calls. If our container can instantiate and include services, it needs to be able to perform both operations.
To be a container, it must be able to store and retrieve instances of the service. This is a fairly simple task compared to creating a service, but it's still worth considering. The container-interop
package provides an interface that a set of containers can implement. The main interface is ContainerInterface
, which defines two methods: one for retrieving services and the other for testing whether the service is defined.
interface ContainerInterface { public function get($id); public function has($id); }
Learn other dependency injection containers
Symfony Dependency Injection Container allows us to define services in many different ways. In YAML, the configuration of the container may look like this:
parameters: # ... mailer.transport: sendmail services: mailer: class: Mailer arguments: ["%mailer.transport%"] newsletter_manager: class: NewsletterManager calls: - [setMailer, ["@mailer"]]
Symfony is very useful in how to divide container configuration into parameters and services. This allows application keys such as API keys, encryption keys, and authentication tokens to be stored in parameter files excluded from the source code repository.
In PHP, the same configuration of the Symfony dependency injection component is as follows:
use Symfony\Component\DependencyInjection\Reference; // ... $container->setParameter('mailer.transport', 'sendmail'); $container ->register('mailer', 'Mailer') ->addArgument('%mailer.transport%'); $container ->register('newsletter_manager', 'NewsletterManager') ->addMethodCall('setMailer', array(new Reference('mailer')));
By using the setMailer
object in a method call to Reference
, the dependency injection logic can detect that this value should not be passed directly, but should be replaced by the service it references in the container. This allows easy injecting PHP values ??and other services into the service without confusion.
Start
First, create a new project directory and create a composer.json
file that Composer can use to automatically load our class. Currently, this file only maps the SitePointContainer
namespace to the src
directory.
interface ContainerInterface { public function get($id); public function has($id); }
Next, since we will make our containers implement container interoperability interfaces, we need to have Composer download them and add them to our composer.json
file:
parameters: # ... mailer.transport: sendmail services: mailer: class: Mailer arguments: ["%mailer.transport%"] newsletter_manager: class: NewsletterManager calls: - [setMailer, ["@mailer"]]
In addition to the main ContainerInterface
, the container-interop
package also defines two exception interfaces. The first one is used for a regular exception encountered when creating a service, and the other is used when the requested service is not found. We will also add another exception to this list when the parameter requested is not found.
(The following content omits the code implementation part because the article is too long and the core logic has been described above. The complete code in the GitHub repository contains the complete implementation of exception classes, reference classes, and container classes.)
Summary
We learned how to create a simple dependency injection container, but there are many other containers that have powerful features that we haven't implemented yet!
Some dependency injection containers, such as PHP-DI and Aura.Di, provide a feature called auto-assembly. Here, the container guesses which services in the container should be injected into other services. To do this, they use the reflection API to find information about constructor parameters.
You can derive the repository as you like and add features like auto-assembly, which is a great exercise! Additionally, we keep a public list of all known derivative versions of this container so that others can see what you are doing. Simply share your work with us using the comments below and we will make sure to add it in.
You can also contact us using the comments below. Let us know what you want to clarify or explain, or any errors you find.
(The FAQs section is omitted as the content is highly duplicated from the above and is too long.)
The above is the detailed content of How to Build Your Own Dependency Injection Container. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics

ToversionaPHP-basedAPIeffectively,useURL-basedversioningforclarityandeaseofrouting,separateversionedcodetoavoidconflicts,deprecateoldversionswithclearcommunication,andconsidercustomheadersonlywhennecessary.StartbyplacingtheversionintheURL(e.g.,/api/v

TosecurelyhandleauthenticationandauthorizationinPHP,followthesesteps:1.Alwayshashpasswordswithpassword_hash()andverifyusingpassword_verify(),usepreparedstatementstopreventSQLinjection,andstoreuserdatain$_SESSIONafterlogin.2.Implementrole-basedaccessc

PHPdoesnothaveabuilt-inWeakMapbutoffersWeakReferenceforsimilarfunctionality.1.WeakReferenceallowsholdingreferenceswithoutpreventinggarbagecollection.2.Itisusefulforcaching,eventlisteners,andmetadatawithoutaffectingobjectlifecycles.3.YoucansimulateaWe

Proceduralandobject-orientedprogramming(OOP)inPHPdiffersignificantlyinstructure,reusability,anddatahandling.1.Proceduralprogrammingusesfunctionsorganizedsequentially,suitableforsmallscripts.2.OOPorganizescodeintoclassesandobjects,modelingreal-worlden

To safely handle file uploads in PHP, the core is to verify file types, rename files, and restrict permissions. 1. Use finfo_file() to check the real MIME type, and only specific types such as image/jpeg are allowed; 2. Use uniqid() to generate random file names and store them in non-Web root directory; 3. Limit file size through php.ini and HTML forms, and set directory permissions to 0755; 4. Use ClamAV to scan malware to enhance security. These steps effectively prevent security vulnerabilities and ensure that the file upload process is safe and reliable.

Yes, PHP can interact with NoSQL databases like MongoDB and Redis through specific extensions or libraries. First, use the MongoDBPHP driver (installed through PECL or Composer) to create client instances and operate databases and collections, supporting insertion, query, aggregation and other operations; second, use the Predis library or phpredis extension to connect to Redis, perform key-value settings and acquisitions, and recommend phpredis for high-performance scenarios, while Predis is convenient for rapid deployment; both are suitable for production environments and are well-documented.

In PHP, the main difference between == and == is the strictness of type checking. ==Type conversion will be performed before comparison, for example, 5=="5" returns true, and ===Request that the value and type are the same before true will be returned, for example, 5==="5" returns false. In usage scenarios, === is more secure and should be used first, and == is only used when type conversion is required.

TostaycurrentwithPHPdevelopmentsandbestpractices,followkeynewssourceslikePHP.netandPHPWeekly,engagewithcommunitiesonforumsandconferences,keeptoolingupdatedandgraduallyadoptnewfeatures,andreadorcontributetoopensourceprojects.First,followreliablesource
