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
Adicione interfaces e traits a classes existentes sem modificar o código-fonte delas nem montar hierarquias de herança.
Adicione uma interface e a sua implementação a cada classe que um pointcut seleciona, a partir de um só lugar.
Dê aos DTOs ou models de um pacote de terceiros a interface da sua aplicação e uma trait reutilizável, sem fazer fork dele.
Veja o exemploA interceptação muda o que acontece quando o código roda. Uma introduction (introdução) muda o que uma classe pode fazer: as suas interfaces e os seus métodos.
Compare os doisComo as introductions são declaradas e como elas se combinam com os outros comportamentos da mesma classe.
Leia a documentaçãoAs duas são declaradas em uma classe de comportamento (na API, um aspect), e as duas deixam os seus arquivos-fonte intactos.
#[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#[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 exemploO 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.
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.
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 e 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)]
cada DTO do pacote
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
sua interface
{
use ChargeOriginalTrait, \App\Export\ExportsPublicProperties;
sua trait
}
Mais em docs/advices.md e docs/configuration.md.
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.
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.
instanceof e as declarações de tipo funcionam, porque a classe que o PHP carrega realmente a implementa.