Change ce qui se passe quand le code existant s’exécute.
#[Around('@execution(App\Attribute\Cacheable)')]La méthode garde sa signature. Un comportement s’exécute autour de chaque appel : mise en cache, journalisation, transactions.
Tout intercepter
Ajoutez des interfaces et des traits à des classes existantes, sans modifier leur code source ni construire de hiérarchies d’héritage.
Ajoutez une interface et son implémentation à chaque classe qu’un pointcut sélectionne, depuis un seul endroit.
Donnez aux DTO ou aux modèles d’un paquet tiers l’interface de votre application et un trait réutilisable, sans forker le paquet.
Voir l’exempleL’interception change ce qui se passe quand le code s’exécute. Une introduction change ce qu’une classe sait faire : ses interfaces et ses méthodes.
Les comparerComment les introductions se déclarent, et comment elles se combinent avec les autres comportements de la même classe.
Lire la documentationLes deux se déclarent dans une classe de comportement (un aspect, dans l’API), et aucune ne touche à vos fichiers source.
#[Around('@execution(App\Attribute\Cacheable)')]La méthode garde sa signature. Un comportement s’exécute autour de chaque appel : mise en cache, journalisation, transactions.
Tout intercepter#[DeclareParents('within(Acme\Payments\Dto\*)', …)]La classe gagne une interface et les méthodes d’un trait. Rien ne s’exécute autour des appels existants ; c’est votre code qui appelle les nouvelles méthodes.
Voir l’exempleVotre pipeline d’export accepte tout ce qui est Exportable. Les DTO du SDK de paiement ne le sont pas, et ils sont déclarés final. Plutôt que de forker le paquet ou d’envelopper chaque DTO dans un adaptateur, une seule classe de comportement leur ajoute à tous votre interface et un trait réutilisable.
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); }}Indiquez le paquet dans includePaths pour qu’il soit compilé comme votre propre code. Compiler du code tiers prend du temps au préchauffage : ne listez que les paquets que vous étendez.
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 et 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)]
chaque DTO du paquet
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
votre interface
{
use ChargeOriginalTrait, \App\Export\ExportsPublicProperties;
votre trait
}
Plus de détails dans docs/advices.md et docs/configuration.md.
Le paquet reste tel que Composer l’a installé. Les mises à jour arrivent toujours avec composer update, et le préchauffage suivant du cache les compile à nouveau.
La classe garde son nom, ses modificateurs et ses parents. L’interface et le trait sont ajoutés à la classe elle-même, pas à une sous-classe.
instanceof et les déclarations de type fonctionnent, car la classe que PHP charge l’implémente réellement.