2.16.0

Ray.Aop 2.16 "Tanabata" Release Notes

This version brings significant changes to the API, simplifying usage and improving integration with the new PECL extension.

Major Changes

New Aspect Class

The most significant change is the introduction of the Aspect class, which simplifies the configuration process:

use Ray\Aop\Aspect;
use Ray\Aop\Matcher;

$aspect = new Aspect();
$aspect->bind(
    (new Matcher())->any(),
    (new Matcher())->annotatedWith(NotOnWeekends::class),
    [new WeekendBlocker()]
);

$billing = $aspect->newInstance(RealBillingService::class);
echo $billing->chargeOrder(); // Interceptors applied 

This replaces the previous approach using Pointcut, Bind, and Weaver classes:

// Old approach (2.0.0 to pre-2.16.0)
$pointcut = new Pointcut(
    (new Matcher())->any(),
    (new Matcher())->annotatedWith(NotOnWeekends::class),
    [new WeekendBlocker()]
);
$bind = (new Bind)->bind(RealBillingService::class, [$pointcut]);
$billing = (new Weaver($bind, $tmpDir))->newInstance(RealBillingService::class, []);

PECL Extension Integration

Ray.Aop 2.16 seamlessly integrates with the new PECL extension. When the extension is installed, you can use the weave method:

$aspect = new Aspect();
$aspect->bind(
    (new Matcher())->any(),
    (new Matcher())->annotatedWith(NotOnWeekends::class),
    [new WeekendBlocker()]
);
$aspect->weave(__DIR__ . '/src'); // Weave the aspects 

$billing = new RealBillingService();
echo $billing->chargeOrder(); // Interceptors applied 

This applies aspects to all classes in a directory, allowing you to use the normal new keyword for instantiation.

Changes

1. The Pointcut, Bind, and Weaver classes are no longer used directly. Instead, use the new Aspect class.
2. The newInstance method is now part of the Aspect class, not Weaver.

Additional Notes

• The PECL extension is optional.
• Existing interceptors and matchers should continue to work without modifications.

We believe these changes will make Ray.Aop easier to use and more powerful. As always, we appreciate your feedback and contributions!

What's Changed

• Add PHP class diagram by @koriym in #213
• PECL extension support and introduce newly refined main class "Aspect" by @koriym in #214

Full Changelog: 2.15.2...2.16.0

2.15.2

What's Changed

• Support enum in attribute arguments by @apple-x-co in #212

Enumerations can now be used for attribute arguments as shown below!

enum FruitEnum
{
    case Apple;
    case Orange;
    case Grape;
}

#[Attribute(Attribute::TARGET_METHOD)]
final class FruitEnum
{
    public function __construct(
        public readonly FruitEnum $fruit1,
        public readonly FruitEnum $fruit2,
    ) {
    }
}

#[AttrFoo(fruit1: FruitEnum::Apple, fruit2: FruitEnum::Orange)]
public function methodFoo() {}

Full Changelog: 2.15.1...2.15.2

2.15.1

What's Changed

Bug Fix 🐞

• Fixed to not make mixed nullable by @koriym in #211

Full Changelog: 2.15.0...2.15.1

2.15.0

What's Changed

• Enable PHP 8.3 compat by @koriym in #204
• Update license copyright year(s) by @github-actions in #207
• Validate tmp directory by @koriym in #209
• Create own codegen by @koriym in #205

Full Changelog: 2.14.0...2.15.0

福島・塩野崎の大桜

2.14.0

What's Changed

• Soothe psalm by @koriym in #200
• Ignore anonymous class compilation by @koriym in #202
• Remove doctrine annotation reader by @koriym in #203

Full Changelog: 2.13.1...2.14.0

2.13.1

What's Changed

• Update license copyright year(s) by @github-actions in #198
• Bump php parser to ^4.13.2 by @NaokiTsuchiya in #199

Full Changelog: 2.13.0...2.13.1

2.13.0

What's Changed

• Enable PHP 8.2 compat by @koriym in #196
• Create attribute_reader.php by @koriym in #197
  • See performance boost

Full Changelog: 2.12.4...2.13.0

2.12.4

What's Changed

• Improve compile performace by @koriym in #192 #195

Full Changelog: 2.12.3...2.12.4

2.12.3

What's Changed

• PHP 8.2-alpha Support by @koriym in #190

Full Changelog: 2.12.2...2.12.3

2.12.2

What's Changed

• Support PHP 7.2 by @koriym in #189

Full Changelog: 2.12.1...2.12.2