PHPackages                             zorac/php-di-migration - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. zorac/php-di-migration

ActiveLibrary[Utility & Helpers](/categories/utility)

zorac/php-di-migration
======================

Eases migration from PHP-DI 6 annotations to PHP-DI 7 attributes

1.0.0(3y ago)0400MITPHPPHP >=8.0

Since Apr 20Pushed 3y ago1 watchersCompare

[ Source](https://github.com/zorac/php-di-migration)[ Packagist](https://packagist.org/packages/zorac/php-di-migration)[ Docs](https://github.com/zorac/php-di-migration)[ RSS](/packages/zorac-php-di-migration/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (4)Versions (2)Used By (0)

PHP-DI Migration
================

[](#php-di-migration)

[![Software license](https://camo.githubusercontent.com/d4d7ba62db47a5c14ede3ab87c4881c50a3645c86723b76f443c82da511a22fc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7a6f7261632f7068702d64692d6d6967726174696f6e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![PHP version](https://camo.githubusercontent.com/93295106909eb50c079ecd8a939fb5c7c73fc902a02e1cd0480803136b3726df/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7a6f7261632f7068702d64692d6d6967726174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://www.php.net/)[![Latest release](https://camo.githubusercontent.com/167f488699550e8c574c683e7671d27bd732335d63042740855feab3418dcf2c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a6f7261632f7068702d64692d6d6967726174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/zorac/php-di-migration)

Eases migration from PHP-DI 6 annotations to PHP-DI 7 attributes.

Rationale
---------

[](#rationale)

PHP-DI 7 replaces the usage of PHPDoc `@Inject` and `@Injectable` annotations with native PHP 8 `#[Inject]` and `#[Injectable]` attributes. This is very much a change for the better, but all of your code needs to be updated at once, which can be difficult or dangerous across a large codebase with multiple contributors. This project provides a smoother migration path by supporting attributes alongside annotations while you migrate your code.

Warning
-------

[](#warning)

This code has not been extensively tested for all use cases and edge cases. Use at your own risk!

Usage
-----

[](#usage)

Install the migration package alongside PHP-DI 6:

```
composer require zorac/php-di-migration
```

Replace `ContainerBuilder` with `MigrationContainerBuilder` and enable annotations:

```
// Before:
$builder = new DI\ContainerBuilder();
$builder->useAnnotations(true);
// etc...
$container = $builder->build();

// After:
$builder = new DI\MigrationContainerBuilder();
$builder->useAnnotations(true);
$builder->useAttributes(true);
// etc...
$container = $builder->build();
```

Commit and merge the changes, and you're ready to start migrating!

Over time, migrate your code from attributes to annotations, remembering to add strong PHP types anywhere you're currently relying on PHPDoc typing, and to remove any imports of `DI\Annotation\Inject` etc.

Once your code is all migrated, remove the `useAnnotations(false)` call from the container builder for final testing. If you missed any typing changes, this is when things will break.

Once you're happy with your fully migrated code, you can remove `zorac/php-di-migration` and upgrade to PHP-DI 7, switching back to using `DI\ContainerBuilder`. You may also be able to remove `doctrine/annotations` if you're not relying on it for anything else.

Congratulations! Your PHP-DI migration is complete.

Implementation Notes
--------------------

[](#implementation-notes)

- `MigrationContainerBuilder` is a modified version of PHP-DI 6's `ContainerBuilder` with changes ported from PHP-DI 7's version to add support for `useAttributes`, and additional changes to support annotations and attributes in parallel.
- `AttributeAndAnnotationBasedAutowiring` is a modified version of PHP-DI 6's `AnnotationBasedAutowiring` with changes ported from PHP-DI 7's `AttributeBasedAutowiring` to support annotations and attributes in parallel.
- All other classes are copied verbatim from PHP-DI 7.

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1170d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2768ebe682a76e86ee591ffccbf100c4f2927c61bce46a955cbf7444585ededa?d=identicon)[zorac](/maintainers/zorac)

---

Top Contributors

[![zorac](https://avatars.githubusercontent.com/u/1845517?v=4)](https://github.com/zorac "zorac (6 commits)")

---

Tags

phpphp-di

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/zorac-php-di-migration/health.svg)

```
[![Health](https://phpackages.com/badges/zorac-php-di-migration/health.svg)](https://phpackages.com/packages/zorac-php-di-migration)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[moodle/moodle

Moodle - the world's open source learning platform

7.2k88.5k80](/packages/moodle-moodle)[phlak/directory-lister

PHP directory lister

2.5k1.4k](/packages/phlak-directory-lister)[infinum/eightshift-libs

WordPress libs developed by Eightshift team to use in modern WordPress.

63125.5k3](/packages/infinum-eightshift-libs)[drupal-code-builder/drupal-code-builder

Code generator for Drupal

27253.3k1](/packages/drupal-code-builder-drupal-code-builder)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)