Uma luz violeta envolve uma fileira de objetos de vidro transparente e dá a cada um uma nova faceta.
Recurso · Extensões de classe

Adicione capacidades a classes que não são suas.

Adicione interfaces e traits a classes existentes sem modificar o código-fonte delas nem montar hierarquias de herança.

Duas formas de estender uma classe

As duas são declaradas em uma classe de comportamento (na API, um aspect), e as duas deixam os seus arquivos-fonte intactos.

Interceptação

Muda o que acontece quando o código existente é executado.

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

O método mantém a sua assinatura. Um comportamento roda em volta de cada chamada: cache, logging, transações.

Intercepte qualquer coisa
Introdução

Muda as capacidades que as classes existentes expõem.

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

A classe ganha uma interface e os métodos de uma trait. Nada roda em volta das chamadas existentes; o seu código chama os novos métodos.

Veja o exemplo
Classes de terceiros

Estenda classes do vendor sem fazer fork delas.

O seu pipeline de exportação aceita qualquer coisa que seja Exportable. Os DTOs do SDK de pagamentos não são, e eles são final. Em vez de fazer fork do pacote ou envolver cada DTO em um adapter, uma única classe de comportamento adiciona a sua interface e uma trait reutilizável a todos eles.

src/Contract/Exportable.phpseu 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);    }}

Indique o pacote em includePaths, para que ele seja compilado como o seu próprio código. Compilar código do vendor custa tempo no aquecimento do cache, então liste só os pacotes que você estende.

public/index.phpkernel
AppKernel::getInstance()->init([    // …    'includePaths' => [        __DIR__ . '/src',        __DIR__ . '/vendor/acme/payments-sdk/src',    ],]);
Em qualquer lugar da sua aplicaçãouso
$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 e readonly
        
        
      
        
        
        {
        
        
        
      
        
        
            public function __construct(
        
        
        
      
        
        
                public string $id,
        
        
        
      
        
        
                public int $amount,
        
        
        
      
        
        
                public string $currency,
        
        
        
      
        
        
            ) {}
        
        
        
      
        
        
        }
        
        
        
      
ExportAspect.phpsua classe de comportamento

        
        
        <?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 do pacote
        
        
      
        
        
            protected null $exportable;
        
        
        
      
        
        
        }
        
        
        
      
Charge.phpgerado

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

Comportamento sem herança

Mais em docs/advices.md e docs/configuration.md.

  • Nenhum fork para manter

    O pacote fica como o Composer o instalou. As atualizações continuam chegando com composer update, e o próximo aquecimento do cache as compila de novo.

  • Classes final e readonly também

    A classe mantém o seu nome, os seus modificadores e as suas classes pai. A interface e a trait são adicionadas a ela, não a uma subclasse.

  • Uma interface de verdade

    instanceof e as declarações de tipo funcionam, porque a classe que o PHP carrega realmente a implementa.