
Aucune magie que vous ne puissiez suivre pas à pas.
Du code généré ne doit pas rimer avec une logique cachée. Le framework produit du PHP lisible que vous pouvez inspecter, comparer, déboguer et suivre pas à pas avec vos outils habituels.
Rien de caché entre votre code et PHP
Ce qui s’exécute, c’est du PHP ordinaire que vous pouvez lire, suivre pas à pas et interroger.
Du code compilé lisible
Votre classe devient un trait et un petit proxy qui porte le nom de votre classe : des fichiers PHP ordinaires, à ouvrir et à lire de bout en bout.
Suivre une classeDéboguez-le comme votre code
En mode debug, les points d’arrêt se déclenchent dans votre fichier d’origine, la pile garde le nom de votre classe, et vous pouvez entrer dans le comportement.
Suivre pas à pasInterrogez le moteur
Les commandes console listent chaque classe de comportement, montrent les méthodes que chacune atteint et compilent le cache à l’avance.
Voir les commandes
Votre classe, et ce qui s’exécute vraiment
Un service de rapports doté d’un comportement de mise en cache, et les deux fichiers que le framework écrit pour lui. Ce sont les vrais fichiers de la session que vous pouvez suivre pas à pas plus bas.
Votre source
Un comportement de mise en cache est attaché avec #[Cacheable]. C’est le fichier que vous ouvrez, que vous lisez et dans lequel vous placez vos points d’arrêt.
<?php
declare(strict_types=1);
namespace App\Report;
use App\Attribute\Cacheable;
class ReportService
{
public function __construct(private OrderRepository $orders) {}
#[Cacheable(ttl: 300)]
mise en cache attachée
public function monthlyRevenue(string $month): int
{
$total = 0;
un point d’arrêt ici s’active
foreach ($this->orders->forMonth($month) as $order) {
$total += $order->cents;
}
return $total;
}
}
Source compilée
Le corps de votre classe, sous forme de trait. Seule la ligne de déclaration change : chaque numéro de ligne est conservé. En mode debug, PHP le charge sous votre chemin d’origine, et le débogueur s’arrête donc dans src/Report/ReportService.php.
<?php
declare(strict_types=1);
namespace App\Report;
use App\Attribute\Cacheable;
trait ReportServiceOriginalTrait
avant : 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
La classe que PHP charge, avec le nom de votre classe : les traces de pile nomment donc ReportService. Le middleware tient en une méthode lisible : construire le joinpoint une fois, puis l’exécuter.
<?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
le nom de votre classe
{
use ReportServiceOriginalTrait {
le corps de votre 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(
construit une fois, au premier appel
self::class,
'monthlyRevenue',
[
Interceptor::around(The::aspect(CachingAspect::class)->cache(...)),
Ctrl-clic ouvre CachingAspect::cache()
],
$this->monthlyRevenueOriginalAlias(...),
votre méthode d’origine
);
return $__joinPoint->__invoke($this, [$month]);
exécute le middleware
}
}
Déboguez-le comme du code que vous avez écrit
Une vraie session de débogage de la même classe, enregistrée puis rejouée dans votre navigateur. Entrez dans l’appel, placez des points d’arrêt dans la marge, ouvrez n’importe quel frame de la pile. Le guide explique ce qui se passe à chaque étape.
Frames
Variables
Console timed under the debugger
Demandez au moteur ce qu’il a fait
La console fournie avec le framework répond aux questions sur votre noyau : quelles classes de comportement il contient et ce que chacune atteint. Elle compile aussi le cache à l’avance. Faites défiler les commandes ; le terminal affiche leur sortie réelle pour l’application ci-dessus.
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.
Créez des comportements. Gardez tout débogable.
La plupart des frameworks vous demandent de faire confiance à la magie. Ici, vous pouvez ouvrir, inspecter et suivre pas à pas chaque ligne qui s’exécute.
Tout le reste, déjà inclus
- PHP purPas d’extension. Pas de boîte noire. Juste du PHP.
- Tout intercepterAucune méthode n’est hors d’atteinte.
- Property hooksInterceptez chaque lecture et chaque écriture de propriété.
- PerformancesCoût nul sans comportement, moins de 1 µs avec.
- Langage de pointcutsSélectionnez exactement le code visé, et testez-le en direct.
- Extensions de classeDe nouvelles interfaces et de nouveaux traits pour des classes existantes.
- S’intègre à votre stackSymfony, Laravel, Yii3 et votre agent de codage IA.