
Nenhuma mágica que você não possa percorrer passo a passo.
Código gerado não deveria significar comportamento escondido. O framework produz PHP legível, que você pode inspecionar, comparar, depurar e percorrer passo a passo com as suas ferramentas de sempre.
Nada escondido entre o seu código e o PHP
O que roda é PHP puro, que você pode ler, percorrer passo a passo e investigar.
Código compilado legível
A sua classe vira uma trait e um pequeno proxy com o nome da sua classe: arquivos PHP comuns que você pode abrir e ler do início ao fim.
Acompanhe uma classeDepure como se fosse seu
No modo debug, os breakpoints disparam no seu arquivo original, a pilha mantém o nome da sua classe e você pode entrar no comportamento.
Percorra passo a passoPergunte ao compilador
Comandos de console listam cada classe de comportamento, mostram quais métodos cada uma alcança e compilam o cache com antecedência.
Veja os comandos
A sua classe, e o que realmente roda
Um serviço de relatórios com um comportamento de cache, e os dois arquivos que o framework grava para ele. São os arquivos reais da sessão que você pode percorrer passo a passo logo abaixo.
O seu código-fonte
Um comportamento de cache é aplicado com #[Cacheable]. Este é o arquivo que você abre, lê e onde coloca breakpoints.
<?php
declare(strict_types=1);
namespace App\Report;
use App\Attribute\Cacheable;
class ReportService
{
public function __construct(private OrderRepository $orders) {}
#[Cacheable(ttl: 300)]
comportamento de cache aplicado
public function monthlyRevenue(string $month): int
{
$total = 0;
um breakpoint aqui dispara
foreach ($this->orders->forMonth($month) as $order) {
$total += $order->cents;
}
return $total;
}
}
Código compilado
O corpo da sua classe como uma trait. Só a linha da declaração muda, então cada número de linha se mantém. No modo debug, o PHP o carrega pelo seu caminho original, então o depurador para em src/Report/ReportService.php.
<?php
declare(strict_types=1);
namespace App\Report;
use App\Attribute\Cacheable;
trait ReportServiceOriginalTrait
antes: class ReportService
{
public function __construct(private OrderRepository $orders) {}
#[Cacheable(ttl: 300)]
public function monthlyRevenue(string $month): int
{
$total = 0;
foreach ($this->orders->forMonth($month) as $order) {
$total += $order->cents;
}
return $total;
}
}
include_once AOP_CACHE_DIR . '/Report/ReportService.php';
Classe proxy
A classe que o PHP carrega, com o nome da sua classe, então os stack traces mostram ReportService. O middleware é um único método legível: monta o joinpoint uma vez e depois o executa.
<?php
declare(strict_types=1);
namespace App\Report;
use Go\Aop\Framework\InterceptorInjector;
use Go\Aop\Framework\Interceptor;
use Go\Aop\Framework\The;
use App\Aspect\CachingAspect;
use Go\Aop\Intercept\DynamicMethodInvocation;
use App\Attribute\Cacheable as Cacheable;
class ReportService implements \Go\Aop\Proxy
o nome da sua classe
{
use ReportServiceOriginalTrait {
o corpo da sua classe
ReportServiceOriginalTrait::monthlyRevenue as private monthlyRevenueOriginalAlias;
}
#[\App\Attribute\Cacheable(ttl: 300)]
public function monthlyRevenue(string $month): int
{
/** @var DynamicMethodInvocation<self, int> $__joinPoint */
static $__joinPoint = InterceptorInjector::forMethod(
montado uma vez, na primeira chamada
self::class,
'monthlyRevenue',
[
Interceptor::around(The::aspect(CachingAspect::class)->cache(...)),
Ctrl-clique abre CachingAspect::cache()
],
$this->monthlyRevenueOriginalAlias(...),
o seu método original
);
return $__joinPoint->__invoke($this, [$month]);
executa o middleware
}
}
Depure como código que você escreveu
Uma sessão de depuração real da mesma classe, gravada e reproduzida no seu navegador. Entre na chamada, coloque breakpoints na margem, abra qualquer frame. O guia explica o que acontece em cada passo.
Frames
Variables
Console timed under the debugger
Pergunte ao compilador o que ele fez
O console que vem com o framework responde perguntas sobre o seu kernel: quais classes de comportamento ele tem e o que cada uma alcança. Ele também compila o cache com antecedência. Role pelos comandos; o terminal mostra a saída real deles para a aplicação acima.
Run the app
php bin/report.phpThe same app, without the debugger. The first call runs the slow query; the second comes from the caching behavior in a hundredth of a millisecond.
List the behavior classes
vendor/bin/aspect debug:aspect bootstrap.phpEvery behavior class (an aspect, in the API) your kernel registers, the file it is defined in, and the advisors it declares. The loader file only boots the kernel; it must not handle a request.
List the advisors
vendor/bin/aspect debug:advisor bootstrap.phpEach advisor with its pointcut. Here there is one:
cache(), for every method marked#[Cacheable].See what an advisor reaches
vendor/bin/aspect debug:advisor bootstrap.php --advisor='App\Aspect\CachingAspect->cache'Analyzes every file below the include paths and lists the members the advisor matches:
monthlyRevenue(), and nothing else.Weave ahead of time
vendor/bin/aspect cache:warmup:aop bootstrap.phpWeaves every file at deploy time, so production serves the prebuilt cache. It fails when a file can’t be woven;
--workers=8weaves in parallel.
2026-10: 21199 cents in 156.16 ms 2026-10: 21199 cents in 0.01 ms
Aspect debug information ======================== App\AppKernel has following enabled aspects: App\Aspect\CachingAspect ------------------------ Defined in: /app/src/Aspect/CachingAspect.php Pointcuts and advices --------- --------------------------------- Type Identifier --------- --------------------------------- Advisor App\Aspect\CachingAspect->cache --------- ---------------------------------
Advisor debug information ========================= List of registered advisors in the container --------------------------------- ------------------------------------- Id Expression --------------------------------- ------------------------------------- App\Aspect\CachingAspect->cache @execution(App\Attribute\Cacheable) --------------------------------- ------------------------------------- If you want to query an information about concrete advisor, then just query it by adding --advisor="Advisor\Name" to the command
Advisor debug information ========================= Total 6 files to analyze. -> matching method App\Report\ReportService->monthlyRevenue
Total 6 files to process. [DONE]: Total processed 6, 0 errors in 5 ms.
Crie comportamentos. Mantenha tudo depurável.
A maioria dos frameworks pede que você confie na mágica. Aqui você pode abrir, inspecionar e percorrer passo a passo cada linha que roda.
Tudo o mais que vem incluído
- PHP puroSem extensões. Sem caixas-pretas. Só PHP.
- Intercepte qualquer coisaNenhum método fica de fora.
- Property hooksIntercepte cada leitura e escrita de propriedade.
- DesempenhoCusto zero sem comportamentos, menos de 1 µs com eles.
- Linguagem de pointcutsSelecione exatamente o código que você quer e teste ao vivo.
- Extensões de classeNovas interfaces e traits para classes existentes.
- Funciona com a sua stackSymfony, Laravel, Yii3 e o seu agente de programação com IA.