Une lumière violette enveloppe une rangée d’objets en verre transparent et donne à chacun une nouvelle facette.
Fonctionnalité · Extensions de classe

Ajoutez des capacités à des classes qui ne sont pas les vôtres.

Ajoutez des interfaces et des traits à des classes existantes, sans modifier leur code source ni construire de hiérarchies d’héritage.

Deux façons d’étendre une classe

Les deux se déclarent dans une classe de comportement (un aspect, dans l’API), et aucune ne touche à vos fichiers source.

Interception

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
Introduction

Change les capacités qu’exposent les classes existantes.

#[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’exemple
Classes tierces

Étendez des classes tierces sans les forker.

Votre 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.

src/Contract/Exportable.phpvotre code
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.

public/index.phpnoyau
AppKernel::getInstance()->init([    // …    'includePaths' => [        __DIR__ . '/src',        __DIR__ . '/vendor/acme/payments-sdk/src',    ],]);
Partout dans votre applicationutilisation
$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']
Charge.phpvendor, intact

        
        
        <?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,
        
        
        
      
        
        
            ) {}
        
        
        
      
        
        
        }
        
        
        
      
ExportAspect.phpvotre classe de comportement

        
        
        <?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;
        
        
        
      
        
        
        }
        
        
        
      
Charge.phpgénéré

        
        
        <?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
        
        
      
        
        
        }
        
        
        
      

Des comportements sans héritage

Plus de détails dans docs/advices.md et docs/configuration.md.

  • Aucun fork à maintenir

    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.

  • Les classes final et readonly aussi

    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.

  • Une vraie interface

    instanceof et les déclarations de type fonctionnent, car la classe que PHP charge l’implémente réellement.