
Никакой магии, которую нельзя отладить по шагам.
Сгенерированный код не содержит скрытую логику. Фреймворк создаёт читаемый PHP, который можно изучить, сравнить, отлаживать и проходить по шагам привычными инструментами.
Между вашим кодом и PHP ничего не спрятано
Выполняется обычный код PHP, который можно прочитать, проходить по шагам и исследовать.
Читаемый скомпилированный код
Ваш класс превращается в трейт и небольшой прокси с именем вашего класса: обычные PHP-файлы, которые можно открыть и прочитать от начала до конца.
Проследить за классомОтлаживайте как свой код
В режиме отладки точки останова срабатывают в вашем исходном файле, стек сохраняет имя вашего класса. В класс поведения можно также зайти.
Пройти по шагамСпросите компилятор
Консольные команды перечисляют все подключенные классы поведений; показывают, какие методы и свойства затрагивает каждый из них; а также помогает заранее скомпилировать кеш.
Посмотреть команды
Ваш класс и то, что выполняется на самом деле
Посмотрим на сервис подготовки отчёта с подключенным поведением кеширования, а также на два файла, которые фреймворк для него формирует. Это настоящие файлы из отладочной XDebug сессии, которую можно пройти по шагам ниже.
Ваш исходный код
Поведение кеширования подключается с помощью атрибута #[Cacheable]. Исходный файл сервиса вы можете открыть, чиать и ставите в нём точки останова.
<?php
declare(strict_types=1);
namespace App\Report;
use App\Attribute\Cacheable;
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;
}
}
Скомпилированный исходный код
Исходный код вашего класса в виде трейта. Изменяется только строка объявления, все исходные номера строк сохраняются. В режиме отладки PHP загружает его через фильтр по вашему исходному пути, поэтому отладчик останавливается в src/Report/ReportService.php.
<?php
declare(strict_types=1);
namespace App\Report;
use App\Attribute\Cacheable;
trait ReportServiceOriginalTrait
было: 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';
Прокси-класс
Класс, который загружает PHP, будет иметь имя вашего исходного класса, поэтому в трассировках стека указан ReportService. Middleware — один читаемый метод: построить joinpoint (точку соединения) один раз, затем выполнить его.
<?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
имя вашего класса
{
use ReportServiceOriginalTrait {
тело вашего класса
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(
создаётся при первом вызове
self::class,
'monthlyRevenue',
[
Interceptor::around(The::aspect(CachingAspect::class)->cache(...)),
Ctrl+клик откроет CachingAspect::cache()
],
$this->monthlyRevenueOriginalAlias(...),
ваш исходный метод
);
return $__joinPoint->__invoke($this, [$month]);
запускает middleware
}
}
Отлаживайте как код, написанный вами
Эмуляция сессии отладки кода, записанная и воспроизводимая в вашем браузере. Сделайте шаг в вызов, ставьте точки останова на полях, открывайте любой фрейм. Подсказки объясняют, что происходит на каждом шаге.
Frames
Variables
Console timed under the debugger
Спросите компилятор, что он сделал
Консоль, которая поставляется с фреймворком, отвечает на вопросы о вашем ядре: какие классы поведений в нём есть и что затрагивает каждый из них. Ещё она заранее компилирует кеш. Пролистайте команды: терминал показывает их настоящий вывод для приложения выше.
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.
Описывайте поведение. Сохраняйте прозрачность.
Большинство фреймворков просят поверить в магию. Здесь каждую строку можно открыть, изучить и пройти по шагам.
Всё остальное в комплекте
- Чистый PHPНикаких расширений. Никаких чёрных ящиков. Только PHP.
- Перехват чего угодноНет методов, закрытых для перехвата.
- Хуки свойствПерехват каждого чтения и записи свойства.
- ПроизводительностьНоль затрат без поведений, меньше 1 мкс с ними.
- Язык срезовВыбирайте ровно тот код, который нужен, и проверяйте вживую.
- Расширения классовНовые интерфейсы и трейты для существующих классов.
- Работает с вашим стекомSymfony, Laravel, Yii3 и ваш ИИ-агент для разработки.