
Никаких расширений. Никаких чёрных ящиков. Только PHP.
Фреймворк работает через Composer и генерирует обычные PHP-файлы с подключёнными поведениями. Читайте их, отлаживайте и запускайте инструментами, которыми уже пользуетесь.
Один Composer-пакет. Никаких лишних инструментов.
Composer устанавливает фреймворк и его PHP-зависимости. Никакого особого расширения PHP, которое нужно включать, никакого бинарника, который нужно поставлять.
composer require goaop/frameworkБез расширения PHP
Ни шага с PECL или PIE, ни кода на C. Компилятор — это Composer-пакет на PHP, поэтому нет расширения, которое нужно устанавливать, включать или пересобирать при смене версии PHP или базового Docker-образа.
Посмотреть установкуБез eval()
Фреймворк никогда не вызывает eval(). Скомпилированные классы записываются в настоящие .php-файлы и загружаются через include, поэтому OPcache их кеширует, а на ревью видна каждая строка.
Проследить за классомСтатические PHP-файлы
Ваш класс превращается в трейт и небольшой прокси-класс с типизированными сигнатурами и generic-докблоками. IDE, PHPStan и сканеры безопасности читают их как ваш собственный код.
Посмотреть типы
Компилятор написан на PHP.
Фреймворк работает как обычный Composer-пакет. Он разбирает ваши классы, сопоставляет их с вашими правилами и генерирует новый PHP-код с подключёнными поведениями. Никакого особого расширения, которое нужно устанавливать, включать или пересобирать.
В режиме разработки классы компилируются при первой загрузке. В продакшене скомпилируйте их один раз при деплое или сборке образа командой cache:warmup:aop. Запросы просто подключают сгенерированные PHP-файлы.
- Никакого особого расширения — нужно только встроенное в PHP расширение tokenizer.
- Никаких пересборок после обновления PHP — достаточно установить совместимые Composer-зависимости и прогреть кеш.
- Один компилятор везде — в разработке, CI и продакшене.
- Продакшен только для чтения — заранее собранные файлы работают на файловой системе только для чтения.
<?php
use Go\Aop\Features;
include __DIR__ . '/../vendor/autoload.php';
ApplicationAspectKernel::getInstance()->init([
'debug' => false,
'appDir' => __DIR__ . '/..',
'cacheDir' => __DIR__ . '/../var/cache/aop',
'includePaths' => [__DIR__ . '/../src'],
'features' => Features::PREBUILT_CACHE,
]);
# install: the weaver is a Composer package
composer require goaop/framework
# deploy: weave the whole cache once
vendor/bin/aspect cache:warmup:aop public/index.php
Сгенерированный PHP загружается как любой другой файл.
Фреймворк генерирует PHP-код, а не выполняет код из строк. Каждый скомпилированный класс даёт два файла в кеше, которые загружаются стандартным include. OPcache обрабатывает их как любые другие PHP-файлы — и каждую сгенерированную строку можно открыть и отладить.
Ваш исходный код
К placeOrder() подключено транзакционное поведение. Ваш файл остаётся ровно таким, каким вы его написали.
<?php
declare(strict_types=1);
namespace App\Order;
final class OrderService
{
public function __construct(
private readonly OrderRepository $orders,
) {}
public function placeOrder(Cart $cart): Order
{
return $this->orders->create($cart);
}
}
Скомпилированный исходник
Тело вашего класса в виде трейта OrderServiceOriginalTrait. Меняется только строка объявления, поэтому номера строк совпадают и точки останова Xdebug по-прежнему срабатывают. Одна добавленная строка загружает прокси.
<?php
declare(strict_types=1);
namespace App\Order;
trait OrderServiceOriginalTrait
было: final class OrderService
{
public function __construct(
private readonly OrderRepository $orders,
) {}
public function placeOrder(Cart $cart): Order
{
return $this->orders->create($cart);
}
}
include_once AOP_CACHE_DIR . '/src/Order/OrderService.php';
Прокси-класс
Класс, который загружает PHP: имя вашего класса, по-прежнему final, с подключённым трейтом. Каждый метод с поведением выполняет его как middleware, а затем вызывает ваш исходный метод через приватный псевдоним.
<?php
declare(strict_types=1);
namespace App\Order;
use Go\Aop\Framework\InterceptorInjector;
use Go\Aop\Framework\Interceptor;
use Go\Aop\Framework\The;
use Go\Aop\Intercept\DynamicMethodInvocation;
use App\Aspect\TransactionAspect;
final class OrderService implements \Go\Aop\Proxy
то же имя, всё ещё final
{
use OrderServiceOriginalTrait {
тело вашего класса
OrderServiceOriginalTrait::placeOrder as private placeOrderOriginalAlias;
}
public function placeOrder(\App\Order\Cart $cart): \App\Order\Order
{
/** @var DynamicMethodInvocation<self, \App\Order\Order> $__joinPoint */
типы для PHPStan и IDE
static $__joinPoint = InterceptorInjector::forMethod(
self::class,
'placeOrder',
[
Interceptor::around(The::aspect(TransactionAspect::class)->inTransaction(...)),
Ctrl+клик откроет поведение
],
$this->placeOrderOriginalAlias(...),
ваш исходный метод
);
return $__joinPoint->__invoke($this, [$cart]);
}
}
Объектно-ориентированный код, понятный PHPStan
Скомпилированный код — это классы и трейты с типизированными сигнатурами, без магических методов посередине. Каждый joinpoint (точка соединения) несёт generic-докблок, поэтому PHPStan и ваша IDE знают, что $__joinPoint->__invoke() возвращает Order, даже внутри каталога кеша.
- Имя класса, ключевое слово final и типизированные сигнатуры сохраняются
- Всё, что выполняется, — файл в кеше, без косвенных вызовов через __call()
- Joinpoints объявляют типы @template, например MethodInvocation<OrderService, Order>
- Пути в кеше повторяют структуру исходников, так что ревьюеры и сканеры находят каждый файл
public function placeOrder(\App\Order\Cart $cart): \App\Order\Order
{
/** @var DynamicMethodInvocation<self, \App\Order\Order> $__joinPoint */
static $__joinPoint = InterceptorInjector::forMethod(
static $__joinPoint
DynamicMethodInvocation<OrderService, Order>__invoke(…): Order
Из докблока @var в скомпилированном файле
self::class,
'placeOrder',
[
Interceptor::around(The::aspect(TransactionAspect::class)->inTransaction(...)),
],
$this->placeOrderOriginalAlias(...),
);
return $__joinPoint->__invoke($this, [$cart]);
}
var/cache/aop/
├── _include.cache # class map for Composer
└── src/
├── Aspect/
│ └── TransactionAspect.cache.php # compiled pointcuts of the behavior
└── Order/
├── OrderService.php # proxy class
└── OrderServiceOriginalTrait.php # your class body
Скомпилированный метод вызывает ваше поведение напрямую, как first-class callable, поэтому IDE может перейти к нему. Подробности — в README.
Всё остальное в комплекте
- Перехват чего угодноНет методов, закрытых для перехвата.
- Хуки свойствПерехват каждого чтения и записи свойства.
- ОтлаживаемостьНикакой магии, которую нельзя пройти по шагам.
- ПроизводительностьНоль затрат без поведений, меньше 1 мкс с ними.
- Язык срезовВыбирайте ровно тот код, который нужен, и проверяйте вживую.
- Расширения классовНовые интерфейсы и трейты для существующих классов.
- Работает с вашим стекомSymfony, Laravel, Yii3 и ваш ИИ-агент для разработки.