What is a Virtual Type in Magento 2?

A Virtual Type in Magento 2 is a way to create a customized version of an existing class using dependency injection configuration without creating a new PHP class.

It allows developers to reuse an existing class but override or modify its constructor arguments through di.xml.

This helps avoid unnecessary subclass creation and keeps the codebase cleaner.

Why use Virtual Types?

Virtual Types allow developers to configure different behaviors for the same class without extending it.

• Avoid creating unnecessary PHP classes.
• Reuse existing classes with different configurations.
• Improve flexibility of dependency injection.
• Allow multiple configurations of the same class.

How Virtual Types Work

A Virtual Type is defined inside di.xml and references an existing class. It acts as a customized instance of that class.

Magento's Object Manager creates the virtual type during runtime with the specified constructor arguments.

Example: Define a Virtual Type

Suppose we want to create a customized version of a class with different constructor arguments.

1. Define Virtual Type in di.xml

(File: app/code/VendorName/ModuleName/etc/di.xml)

Example: Use the Virtual Type in a Class

The virtual type can now be injected just like any other dependency.

(File: app/code/VendorName/ModuleName/Model/Test.php)

Difference Between Virtual Type and Preference

• Virtual Type creates a customized version of an existing class.
• Preference replaces the original class with another class.
• Virtual Type does not override the original class.
• Preference completely replaces the implementation.

Difference Between Virtual Type and Plugin

• Virtual Type changes constructor configuration.
• Plugin modifies method behavior.
• Virtual Type works during object creation.
• Plugin works during method execution.

Best Practices

• Use Virtual Types to configure existing classes differently.
• Avoid creating unnecessary subclass implementations.
• Use meaningful names for virtual types.
• Use Virtual Types mainly for dependency configuration.