Белый луч проходит насквозь через прозрачный стеклянный блок с мягкой красной подсветкой по краю.
Возможность · Чистый PHP

Никаких расширений. Никаких чёрных ящиков. Только PHP.

Фреймворк работает через Composer и генерирует обычные PHP-файлы с подключёнными поведениями. Читайте их, отлаживайте и запускайте инструментами, которыми уже пользуетесь.

Один Composer-пакет. Никаких лишних инструментов.

Composer устанавливает фреймворк и его PHP-зависимости. Никакого особого расширения PHP, которое нужно включать, никакого бинарника, который нужно поставлять.

composer require goaop/framework
Без расширения PHP

Компилятор написан на PHP.

Фреймворк работает как обычный Composer-пакет. Он разбирает ваши классы, сопоставляет их с вашими правилами и генерирует новый PHP-код с подключёнными поведениями. Никакого особого расширения, которое нужно устанавливать, включать или пересобирать.

В режиме разработки классы компилируются при первой загрузке. В продакшене скомпилируйте их один раз при деплое или сборке образа командой cache:warmup:aop. Запросы просто подключают сгенерированные PHP-файлы.

  • Никакого особого расширения — нужно только встроенное в PHP расширение tokenizer.
  • Никаких пересборок после обновления PHP — достаточно установить совместимые Composer-зависимости и прогреть кеш.
  • Один компилятор везде — в разработке, CI и продакшене.
  • Продакшен только для чтения — заранее собранные файлы работают на файловой системе только для чтения.
index.phpпродакшен

        
        
        <?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,
        
        
        
      
        
        
        ]);
        
        
        
      
Terminalдеплой

        
        
        # 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
        
        
        
      
Без eval()

Сгенерированный PHP загружается как любой другой файл.

Фреймворк генерирует PHP-код, а не выполняет код из строк. Каждый скомпилированный класс даёт два файла в кеше, которые загружаются стандартным include. OPcache обрабатывает их как любые другие PHP-файлы — и каждую сгенерированную строку можно открыть и отладить.

Ваш исходный код

К placeOrder() подключено транзакционное поведение. Ваш файл остаётся ровно таким, каким вы его написали.

OrderService.phpваш код

        
        
        <?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 по-прежнему срабатывают. Одна добавленная строка загружает прокси.

OrderServiceOriginalTrait.phpскомпилировано

        
        
        <?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, а затем вызывает ваш исходный метод через приватный псевдоним.

OrderService.phpсгенерировано

        
        
        <?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]);
        
        
        
      
        
        
            }
        
        
        
      
        
        
        }
        
        
        
      
Статические PHP-файлы

Объектно-ориентированный код, понятный PHPStan

Скомпилированный код — это классы и трейты с типизированными сигнатурами, без магических методов посередине. Каждый joinpoint (точка соединения) несёт generic-докблок, поэтому PHPStan и ваша IDE знают, что $__joinPoint->__invoke() возвращает Order, даже внутри каталога кеша.

  • Имя класса, ключевое слово final и типизированные сигнатуры сохраняются
  • Всё, что выполняется, — файл в кеше, без косвенных вызовов через __call()
  • Joinpoints объявляют типы @template, например MethodInvocation<OrderService, Order>
  • Пути в кеше повторяют структуру исходников, так что ревьюеры и сканеры находят каждый файл
OrderService.phpтипы

        
        
            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]);
        
        
        
      
        
        
            }
        
        
        
      
Projectкаталог кеша

        
        
        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.