ray/di

2.23.0

Added

• Write bindings.md at composition time: the injector records how the container was composed — every binding with its provenance — via BindingLog, BindingEvent, and the core Ray\Di\BindingsMarkdown renderer (#336).
• Add Ray\Di\ModuleVisitorInterface as the stable route for tools to visit a module's composed container via AbstractModule::accept() (#336).

Removed

• Move rich binding visualization out of core: Ray\Bindings\Bindings, Ray\Bindings\BindingsHtml, Ray\Bindings\BindingsMarkdown, and the bin/bindings-html command now live in the standalone ray/bindings package (composer require --dev ray/bindings). These APIs were introduced in 2.22.1; the composition-time bindings.md above remains in core (#336).

Fixed

• Fix multibindings being lost from all but the first installed module (#340).
• Distinguish an empty multibinding set from an undeclared one (#341).
• Keep the first install's entry on a same-key multibinding collision (#348).
• Exclude the MultiBindings index from the BindingLog (#347).
• Roll back the singleton cache when @PostConstruct throws (#346).
• Fix exception messages to follow the value-only convention (#339).

Full Changelog: https://github.com/ray-di/Ray.Di/blob/2.x/CHANGELOG.md

Added

• Write bindings.md at composition time: the injector records how the container was composed — every binding with its provenance — via BindingLog, BindingEvent, and the core Ray\Di\BindingsMarkdown renderer (#336).
• Add Ray\Di\ModuleVisitorInterface as the stable route for tools to visit a module's composed container via AbstractModule::accept() (#336).

Removed

• Move rich binding visualization out of core: Ray\Bindings\Bindings, Ray\Bindings\BindingsHtml, Ray\Bindings\BindingsMarkdown, and the bin/bindings-html command now live in the standalone ray/bindings package (composer require --dev ray/bindings). These APIs were introduced in 2.22.1; the composition-time bindings.md above remains in core (#336).

Fixed

• Fix multibindings being lost from all but the first installed module (#340).
• Distinguish an empty multibinding set from an undeclared one (#341).
• Keep the first install's entry on a same-key multibinding collision (#348).
• Exclude the MultiBindings index from the BindingLog (#347).
• Roll back the singleton cache when @PostConstruct throws (#346).
• Fix exception messages to follow the value-only convention (#339).

Included pull requests

• #336 Binding diagnostics as a core artifact
• #339 Fix exception messages to follow value-only convention
• #340 Fix multibindings being lost from all but the first installed module
• #341 Distinguish an empty multibinding set from an undeclared one
• #344 Bump squizlabs/php_codesniffer from 4.0.1 to 4.0.2
• #346 Roll back the singleton cache when @PostConstruct throws
• #347 Exclude the MultiBindings index from the BindingLog
• #348 Keep the first install's entry on a same-key multibinding collision

Fixed

• Non-instantiable concrete classes (e.g. private constructors) are no longer just-in-time bound. Requesting an unbound non-instantiable class fails with Ray\Di\Exception\Unbound instead of a bare PHP Error (Call to private ...::__construct()), which became more visible after NewInstance switched to language-level new in 2.21 (#335).

Just-in-time binding of public instantiable concrete classes at the top level is unchanged.

Fixed

• Reject non-instantiable classes (for example private constructors) from just-in-time binding. They now fail with Unbound instead of a bare PHP Error after language-level new in NewInstance (#335).

Added

• Detect circular dependencies and report them with a dedicated exception, instead of recursing until the process dies (#319).
• Add a binding provenance log recording how each binding was composed, and Ray\Bindings\Bindings snapshots for rendering it as Markdown or HTML — collected explicitly with $module->accept(new Bindings()) (#323, #331).
• Add the Ray\Bindings\BindingsHtml viewer and the bin/bindings-html command (#325, #330).

Changed

• Improve module composition compatibility and DI hot-path performance (#316, #319, #333).
• Update the CI and development toolchain for PHP 8.5, PHPUnit 11, PHP_CodeSniffer 4, and mutation testing (#315, #317, #326).

Deprecated

• Mark InvalidContext, InvalidToConstructorNameParameter, and the base Ray\Di\Exception as deprecated and relocate them to src-deprecated/; none has been thrown since earlier releases tightened the related method signatures (#329).

Fixed

• Preserve provider constructor injection points during dependency resolution (#320).
• Correct JIT binding recursion, singleton handling, multi-binding scope clearing, and multi-interceptor registration (#318, #319).
• Fix assisted injection re-entry with Ray.Aop 2.22's parent-call dispatch, and preserve explicit null arguments during assisted injection (#328).
• Reject a rename onto an index that already has a binding instead of silently destroying it (#319).

Included pull requests

• #311 Update license copyright year(s)
• #315 Add mutation testing with Infection framework
• #316 Improve DI hot path performance
• #317 Raise mutation MSI to 90%
• #318 Fix DI bugs and cleanups
• #319 Fix core resolution and module composition
• #320 Preserve provider injection points
• #323 Add binding provenance logging
• #325 Add the bindings HTML viewer
• #326 Bump CI tooling to PHP 8.5/8.4
• #328 Fix assisted injection re-entry
• #329 Make exception phpdoc consistent and self-documenting
• #330 Disambiguate shared PSR-4 source links
• #331 Add an explicit bindings snapshot API
• #333 Restore rename() to its wrapper transformation

Added

• Detect circular dependencies and report them with a dedicated exception, instead of recursing until the process dies (#319).
• Add a binding provenance log recording how each binding was composed, and Ray\Bindings\Bindings snapshots for rendering it as Markdown or HTML — collected explicitly with $module->accept(new Bindings()) (#323, #331).
• Add the Ray\Bindings\BindingsHtml viewer and the bin/bindings-html command (#325, #330).

Changed

• Improve module composition compatibility and DI hot-path performance (#316, #319, #333).
• Update the CI and development toolchain for PHP 8.5, PHPUnit 11, PHP_CodeSniffer 4, and mutation testing (#315, #317, #326).

Deprecated

• Mark InvalidContext, InvalidToConstructorNameParameter, and the base Ray\Di\Exception as deprecated and relocate them to src-deprecated/; none has been thrown since earlier releases tightened the related method signatures (#329).

Fixed

• Preserve provider constructor injection points during dependency resolution (#320).
• Correct JIT binding recursion, singleton handling, multi-binding scope clearing, and multi-interceptor registration (#318, #319).
• Fix assisted injection re-entry with Ray.Aop 2.22's parent-call dispatch, and preserve explicit null arguments during assisted injection (#328).
• Reject a rename onto an index that already has a binding instead of silently destroying it (#319).

Included pull requests

• #311 Update license copyright year(s)
• #315 Add mutation testing with Infection framework
• #316 Improve DI hot path performance
• #317 Raise mutation MSI to 90%
• #318 Fix DI bugs and cleanups
• #319 Fix core resolution and module composition
• #320 Preserve provider injection points
• #323 Add binding provenance logging
• #325 Add the bindings HTML viewer
• #326 Bump CI tooling to PHP 8.5/8.4
• #328 Fix assisted injection re-entry
• #329 Make exception phpdoc consistent and self-documenting
• #330 Disambiguate shared PSR-4 source links
• #331 Add an explicit bindings snapshot API
• #333 Restore rename() to its wrapper transformation

What's Changed

New Features

• Add NoHint exception for parameters without type hints or binding names
• Improve Unbound error messages with better formatting

Developer Experience

• Drop PHPUnit 8.x support (PHPUnit 9.5+ required)

Full Changelog: 2.19.3...2.20.0

Changed

• Enhanced BcParameterQualifier to support method-level Qualifier attributes on constructors

What's Changed

Backward Compatibility Enhancement

This release adds backward compatibility for method-level InjectInterface+Qualifier attributes on single-parameter setter methods, and improves naming consistency for deprecated code.

New: BcParameterQualifier

• Automatically applies method-level InjectInterface+Qualifier attributes to parameters for single-parameter setters
• Restores backward compatibility for code using combined attributes like #[FakeLogDbInject]
• Only applies when attribute supports Attribute::TARGET_PARAMETER (distinguishes from Provider pattern)
• Located in src-deprecated/di/ and marked as @deprecated

Example (now works):

#[FakeLogDbInject]  // InjectInterface + Qualifier
public function setDb(ExtendedPdoInterface $pdo) { }

Recommended Modern Approach:

#[Inject]
public function setDb(#[FakeLogDb] ExtendedPdoInterface $pdo) { }

Naming Improvements:

• Renamed: LegacyStringParser → BcStringParser for consistency
• All backward compatibility code now uses Bc prefix (Backward Compatibility)
• Clearer, more concise naming throughout deprecated code

Technical Details:

• New class: Ray\Di\BcParameterQualifier with getNames() method
• Renamed: Ray\Di\LegacyStringParser → Ray\Di\BcStringParser
• Comprehensive test coverage for both BC features
• Ray.Compiler compatible (inference happens at compile-time)

This ensures compatibility with packages like Ray.AuraSqlModule that use method-level qualifier attributes.

Full Changelog: 2.19.1...2.19.2

What's Changed

Backward Compatibility Fix

This release restores backward compatibility for the string format in toConstructor() method that was accidentally removed in 2.19.0 (commit da864a5).

Restored Support:

• String format: toConstructor(ClassName::class, 'param=name,param2=name2')
• This format is now handled by the new LegacyStringParser class in src-deprecated/di/
• Marked as @deprecated - prefer using parameter-level attributes or array format

Recommended Modern Approaches:

• Parameter-level attributes: #[Named('name')] on constructor parameters
• Array format: toConstructor(ClassName::class, ['param' => 'name'])

Technical Details:

• New class: Ray\Di\LegacyStringParser for parsing legacy string format
• Updated: Ray\Di\Name to delegate string parsing to LegacyStringParser
• Added comprehensive tests for string format parsing

This fix ensures that existing code using Ray.AuraSqlModule and other packages relying on the string format will continue to work.

Full Changelog: 2.19.0...2.19.1

Changed

• Move ray/compiler to suggested dependency (#304)
  ray/compiler is no longer required. Ray.Di only uses Ray\Aop\Compiler from ray/aop.

• Optimize codebase for PHP 8.2+ (#305)
  Modernized code with readonly properties, constructor property promotion, and improved type declarations.
  43 files changed: +166 -299 lines

Fixed

• Remove unused AnnotationException references
• Improve test coverage for optional setter injection

Requirements

• PHP 8.2+
• ray/aop ^2.19

What's Changed

• Bug fix: Handle missing dependencies in setter methods with #[Inject(optional: true)] by @koriym in #292
• PHP 8.4 Support: Update CI to support PHP 8.4 and include PHP 8.3 in old_stable by @koriym in #293
• Enhance code quality with Psalm annotations by @koriym in #294

Full Changelog: 2.17.2...2.18.0

What's Changed

• Serializable provider provider by @koriym in #291

PDOをプロパティに持つクラスは通常シリアライズができませんが、以下のようにPDOではなくPDOのプロバイダーを注入することによりシリアライズが可能になります。

Classes that have PDO as a property cannot normally be serialized, but they can be serialized by injecting a lazy object as follows.

class LazyPdo
{

    private PDO $pdo;

    public function __construct(
        /** ProviderInterface<PDO> */
        #[Set(PDO::class)] private ProviderInterface $pdoProvider
    ) {
        $this->pdoProvider = $pdoProvider;
        $this->initialize($pdoProvider);
    }
    
    public function initialize(ProviderInterface $pdoProvider)
    {
        $this->pdo = $this->pdoProvider->get();
    }
    
    public function __serialize(): array
    {
        return [
            'pdoProvider' => $this->pdoProvider
        ];
    }
    
    public function __unserialize(array $data): void
    {
        $this->pdoProvider = $data['pdoProvider'];
        $this->initialize($data['pdoProvider']);
    }
}

Full Changelog: 2.17.1...2.17.2