Una luz violeta envuelve una fila de objetos de vidrio transparente y le da a cada uno una nueva faceta.
Funcionalidad · Extensiones de clase

Añade capacidades a clases que no son tuyas.

Añade interfaces y traits a clases existentes sin modificar su código fuente ni construir jerarquías de herencia.

Dos formas de extender una clase

Ambas se declaran en una clase de comportamiento (un aspect, en la API) y ninguna toca tus archivos fuente.

Intercepción

Cambia lo que ocurre cuando se ejecuta el código existente.

#[Around('@execution(App\Attribute\Cacheable)')]

El método conserva su firma. Un comportamiento se ejecuta alrededor de cada llamada: caché, logging, transacciones.

Intercepta cualquier cosa
Introducción

Cambia las capacidades que exponen las clases existentes.

#[DeclareParents('within(Acme\Payments\Dto\*)', …)]

La clase gana una interfaz y los métodos de un trait. Nada se ejecuta alrededor de las llamadas existentes; tu código llama a los nuevos métodos.

Ver el ejemplo
Clases de terceros

Extiende clases de vendor sin hacerles un fork.

Tu pipeline de exportación acepta cualquier cosa que sea Exportable. Los DTO del SDK de pagos no lo son, y además son final. En lugar de hacer un fork del paquete o envolver cada DTO en un adaptador, una sola clase de comportamiento les añade a todos tu interfaz y un trait reutilizable.

src/Contract/Exportable.phptu código
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);    }}

Indica el paquete en includePaths para que se compile como tu propio código. Compilar código de vendor cuesta tiempo en el precalentamiento, así que incluye solo los paquetes que extiendes.

public/index.phpkernel
AppKernel::getInstance()->init([    // …    'includePaths' => [        __DIR__ . '/src',        __DIR__ . '/vendor/acme/payments-sdk/src',    ],]);
En cualquier parte de tu appuso
$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, intacto

        
        
        <?php
        
        
        
      
        
        
         
        
        
        
      
        
        
        declare(strict_types=1);
        
        
        
      
        
        
         
        
        
        
      
        
        
        namespace Acme\Payments\Dto;
        
        
        
      
        
        
         
        
        
        
      
        
        
        final readonly class Charge
        final y readonly
        
        
      
        
        
        {
        
        
        
      
        
        
            public function __construct(
        
        
        
      
        
        
                public string $id,
        
        
        
      
        
        
                public int $amount,
        
        
        
      
        
        
                public string $currency,
        
        
        
      
        
        
            ) {}
        
        
        
      
        
        
        }
        
        
        
      
ExportAspect.phptu clase de comportamiento

        
        
        <?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)]
        cada DTO del paquete
        
        
      
        
        
            protected null $exportable;
        
        
        
      
        
        
        }
        
        
        
      
Charge.phpgenerado

        
        
        <?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
        tu interfaz
        
        
      
        
        
        {
        
        
        
      
        
        
            use ChargeOriginalTrait, \App\Export\ExportsPublicProperties;
        tu trait
        
        
      
        
        
        }
        
        
        
      

Comportamiento sin herencia

Más en docs/advices.md y docs/configuration.md.

  • Ningún fork que mantener

    El paquete queda tal como lo instaló Composer. Las actualizaciones siguen llegando con composer update, y el siguiente precalentamiento de la caché las vuelve a compilar.

  • También clases final y readonly

    La clase conserva su nombre, sus modificadores y sus padres. La interfaz y el trait se añaden a ella, no a una subclase.

  • Una interfaz real

    instanceof y las declaraciones de tipo funcionan, porque la clase que carga PHP de verdad la implementa.