Intercepte qualquer coisaPlayground de pointcuts

Escreva uma regra. Veja o que ela seleciona.

Selecione código por nome, visibilidade, tipo de retorno ou atributos. Edite o pointcut e o código PHP e veja cada correspondência destacada diretamente no código.

Selects 12 joinpoints · 2 can’t be intercepted

Start with an example. Make it your own.

Playground.phpeditable

Selected joinpoints

This matcher runs in your browser and reads one file, following the documented grammar. The weaver itself reflects your real classes, their parents and traits.

Guia rápido de pointcuts

As formas que o playground entende, tiradas da referência de pointcuts do framework. Os argumentos nunca entram na correspondência: a lista de argumentos é sempre (*).

Pointcuts

execution(public App\Service->save(*))
Chamadas de um método de instância
execution(public App\Service::create(*))
Chamadas de um método estático
execution(App\Service\file_get_contents(*))
Chamadas de uma função do PHP feitas por código naquele namespace
access(public App\Entity\User->email)
Leituras e escritas de uma propriedade
within(App\Model\*)
Todos os métodos e propriedades das classes que correspondem
initialization(App\Model\Order)
Criação de objetos com new
staticinitialization(App\Model\*)
O primeiro carregamento das classes que correspondem
@execution(App\Attribute\Logged)
Métodos que têm o atributo
@access(App\Attribute\Audited)
Propriedades que têm o atributo
@within(App\Attribute\Monitored)
Todos os membros das classes que têm o atributo

Padrões e operadores

*
Quaisquer caracteres de uma parte do nome, sem nunca atravessar um \
**
Qualquer profundidade de namespace: App\** é toda classe abaixo de App
get*|is*
Alternativas dentro de uma parte do nome
Foo+
Foo, as suas subclasses e implementações, e as classes que usam a trait Foo
public|protected
Alternativas de modificadores; também final, readonly, private(set)
: App\Entity|null
Restringe o tipo de retorno declarado
&& || ! ( )
Combine, negue e agrupe pointcuts
matchInherited()
Só membros herdados ou vindos de uma trait
Referência completa de pointcuts
Baseado em atributos

Defina os seus próprios atributos de comportamento.

Crie atributos PHP personalizados, associe comportamentos a eles e marque só os métodos que precisam deles. O código da sua aplicação continua independente do framework.

O plugin para IDEA adiciona destaque de sintaxe e autocompletar de pointcuts diretamente dentro dos seus atributos.

src/Attribute/Transactional.phpseu código
#[\Attribute(\Attribute::TARGET_METHOD)]final class Transactional {}
src/Aspect/TransactionAspect.phptransações
final class TransactionAspect implements Aspect{    #[Around('@execution(App\Attribute\Transactional) && !within(App\Legacy\**)')]    public function inTransaction(MethodInvocation $invocation): mixed    {        return $this->db->transactional(            fn () => $invocation->proceed()        );    }}
src/Order/OrderService.phpdomínio
#[Transactional]public function placeOrder(Cart $cart): Order{    return $this->orders->create($cart);}