Ändert, was passiert, wenn bestehender Code läuft.
#[Around('@execution(App\Attribute\Cacheable)')]Die Methode behält ihre Signatur. Ein Verhalten läuft um jeden Aufruf: Caching, Logging, Transaktionen.
Alles abfangen
Fügen Sie bestehenden Klassen Interfaces und Traits hinzu, ohne ihren Quelltext zu ändern oder Vererbungshierarchien aufzubauen.
Geben Sie jeder Klasse, die ein Pointcut auswählt, ein Interface samt Implementierung, an einer einzigen Stelle.
Geben Sie den DTOs oder Models eines Fremdpakets das Interface Ihrer Anwendung und einen wiederverwendbaren Trait, ohne das Paket zu forken.
Zum BeispielInterception ändert, was passiert, wenn Code läuft. Eine Introduction ändert, was eine Klasse kann: ihre Interfaces und Methoden.
VergleichenWie Introductions deklariert werden und wie sie mit dem übrigen Verhalten derselben Klasse zusammenspielen.
Zur DokumentationBeide werden in einer Verhaltensklasse deklariert (in der API ein Aspect), und beide lassen Ihre Quelldateien unberührt.
#[Around('@execution(App\Attribute\Cacheable)')]Die Methode behält ihre Signatur. Ein Verhalten läuft um jeden Aufruf: Caching, Logging, Transaktionen.
Alles abfangen#[DeclareParents('within(Acme\Payments\Dto\*)', …)]Die Klasse erhält ein Interface und die Methoden eines Traits. Um bestehende Aufrufe läuft nichts; Ihr Code ruft die neuen Methoden auf.
Zum BeispielIhre Export-Pipeline akzeptiert alles, was Exportable ist. Die DTOs des Payment-SDKs sind es nicht, und sie sind final. Statt das Paket zu forken oder jedes DTO in einen Adapter zu packen, fügt eine einzige Verhaltensklasse allen Ihr Interface und einen wiederverwendbaren Trait hinzu.
interface Exportable{ /** @return array<string, scalar|null> */ public function toExportRow(): array;} // src/Export/ExportsPublicProperties.phptrait ExportsPublicProperties{ public function toExportRow(): array { return get_object_vars($this); }}Nennen Sie das Paket in includePaths, damit es wie Ihr eigener Code kompiliert wird. Vendor-Code zu kompilieren kostet Zeit beim Warm-up, also listen Sie nur die Pakete auf, die Sie erweitern.
AppKernel::getInstance()->init([ // … 'includePaths' => [ __DIR__ . '/src', __DIR__ . '/vendor/acme/payments-sdk/src', ],]);$charge = new Charge('ch_1', 4200, 'EUR'); // a vendor DTO $charge instanceof Exportable; // true$exporter->write($charge); // accepts any Exportable$charge->toExportRow(); // ['id' => 'ch_1', 'amount' => 4200, 'currency' => 'EUR']
<?php
declare(strict_types=1);
namespace Acme\Payments\Dto;
final readonly class Charge
final und readonly
{
public function __construct(
public string $id,
public int $amount,
public string $currency,
) {}
}
<?php
declare(strict_types=1);
namespace App\Aspect;
use App\Contract\Exportable;
use App\Export\ExportsPublicProperties;
use Go\Aop\Aspect;
use Go\Lang\Attribute\DeclareParents;
final class ExportAspect implements Aspect
{
#[DeclareParents('within(Acme\Payments\Dto\*)', interfaceName: Exportable::class, traitName: ExportsPublicProperties::class)]
jedes DTO des Pakets
protected null $exportable;
}
<?php
declare(strict_types=1);
namespace Acme\Payments\Dto;
use Go\Aop\Framework\InterceptorInjector;
use Go\Aop\Framework\Interceptor;
use Go\Aop\Framework\The;
final readonly class Charge implements \App\Contract\Exportable, \Go\Aop\Proxy
Ihr Interface
{
use ChargeOriginalTrait, \App\Export\ExportsPublicProperties;
Ihr Trait
}
Mehr in docs/advices.md und docs/configuration.md.
Das Paket bleibt, wie Composer es installiert hat. Updates kommen weiter mit composer update, und das nächste Cache-Warm-up kompiliert sie erneut.
Die Klasse behält ihren Namen, ihre Modifier und ihre Elternklassen. Interface und Trait kommen zu ihr hinzu, nicht zu einer Unterklasse.
instanceof und Typdeklarationen funktionieren, denn die Klasse, die PHP lädt, implementiert es wirklich.