
Перехват каждого чтения и записи свойства.
Проверяйте, нормализуйте и аудируйте доступ к свойствам без геттеров, сеттеров и магических методов. Подключайте поведения прямо к свойствам, а код остаётся читаемым и пригодным для статического анализа.
Поведения на свойствах, а не на сеттерах
Отметьте свойство атрибутом, и каждое его чтение и запись автоматически запустит заданные вами поведения.
Почти* любое свойство
Проверяйте, нормализуйте или аудируйте публичные, защищённые, приватные, объявленные в конструкторе и final-свойства, сохраняя асимметричную видимость.
Что поддерживаетсяКак это работает
Отмеченные свойства возвращаются в класс, который загружает PHP, в виде нативных get- и set-хуков PHP 8.4, которые запускают поведение.
Проследить за классомЖурнал аудита
Отметьте свойства атрибутом #[Auditable] и записывайте каждое изменение со старым и новым значением, откуда бы ни пришла запись.
Посмотреть поведение
Что можно перехватить
Чтение и запись объявленных вами свойств проходят через поведение: проверяйте, нормализуйте или аудируйте их. При записи proceed() возвращает значение, которое будет сохранено, так что поведение вокруг записи может изменить его до сохранения.
- Публичные, защищённые и приватные свойства, объявленные в классе
- Свойства из конструктора (promoted) и final-свойства: присваивание в конструкторе — это запись
- Публичные и защищённые свойства, унаследованные от родительского класса
- Асимметричная видимость (private(set)) и атрибуты сохраняются
- Свойства-массивы по-прежнему работают с array_push() через хуки &get
- Не поддерживается: *Статические, readonly-свойства и свойства, у которых уже есть хуки, остаются без изменений: PHP не допускает для них хуков.
#[Around('access(public App\Entity\User->email)')]public function normalizeEmail(FieldAccess $access): mixed{ if ($access->getAccessType() === FieldAccessType::Write) { return strtolower($access->proceed()); } return $access->proceed();}Нативные хуки PHP. Генерируются автоматически.
Фреймворк превращает ваш класс в обычные PHP-файлы. Отмеченные свойства переписываются с нативными хуками get и set из PHP 8.4+, которые вызывают подключённые поведения при каждом обращении к свойству.
Ваш класс
Два свойства помечены #[Auditable] — атрибутом, который ищет поведение аудита ниже; третье — нет. Файл остаётся ровно таким, каким вы его написали.
<?php
declare(strict_types=1);
namespace App\Entity;
use App\Attribute\Auditable;
class Customer
{
#[Auditable]
public string $email = '';
#[Auditable]
public string $plan = 'free';
public string $displayName = '';
public function upgrade(string $plan): void
{
$this->plan = $plan;
}
}
Скомпилированный исходник
Тело вашего класса в виде трейта CustomerOriginalTrait. На месте каждого отмеченного свойства остаётся однострочная пометка, а все остальные строки сохраняют свои номера для Xdebug.
<?php
declare(strict_types=1);
namespace App\Entity;
use App\Attribute\Auditable;
trait CustomerOriginalTrait
было: class Customer
{
/* Moved by weaving interceptor to the {@see App\Entity\Customer->email} */
/* Moved by weaving interceptor to the {@see App\Entity\Customer->plan} */
public string $displayName = '';
public function upgrade(string $plan): void
{
$this->plan = $plan;
}
}
include_once AOP_CACHE_DIR . '/src/Entity/Customer.php';
Прокси-класс с хуками
Класс, который загружает PHP: имя вашего класса, трейт и отмеченные свойства, объявленные заново с атрибутом, типом и значением по умолчанию, плюс хуки get и set. Каждый хук пропускает обращение через middleware аудита.
<?php
declare(strict_types=1);
namespace App\Entity;
use Go\Aop\Framework\InterceptorInjector;
use Go\Aop\Framework\Interceptor;
use Go\Aop\Framework\The;
use Go\Aop\Intercept\FieldAccess;
use App\Aspect\AuditAspect;
use App\Attribute\Auditable;
class Customer implements \Go\Aop\Proxy
то же имя класса
{
use CustomerOriginalTrait;
остальной ваш класс
#[\App\Attribute\Auditable]
атрибут сохранён
public string $email = '' {
нативные хуки PHP 8.4
get {
/** @var FieldAccess<self, string> $__joinPoint */
типы для PHPStan и IDE
static $__joinPoint = InterceptorInjector::forProperty(
self::class,
'email',
[
Interceptor::around(The::aspect(AuditAspect::class)->auditWrite(...)),
ваше поведение аудита
],
);
return $__joinPoint->read($this, $this->email);
чтение проходит напрямую
}
set {
/** @var FieldAccess<self, string> $__joinPoint */
static $__joinPoint = InterceptorInjector::forProperty(
self::class,
'email',
[
Interceptor::around(The::aspect(AuditAspect::class)->auditWrite(...)),
],
);
$this->email = $__joinPoint->write($this, $value, $this->email);
запись идёт через поведение
}
}
#[\App\Attribute\Auditable]
public string $plan = 'free' {
get {
/** @var FieldAccess<self, string> $__joinPoint */
static $__joinPoint = InterceptorInjector::forProperty(
self::class,
'plan',
[
Interceptor::around(The::aspect(AuditAspect::class)->auditWrite(...)),
],
);
return $__joinPoint->read($this, $this->plan);
}
set {
/** @var FieldAccess<self, string> $__joinPoint */
static $__joinPoint = InterceptorInjector::forProperty(
self::class,
'plan',
[
Interceptor::around(The::aspect(AuditAspect::class)->auditWrite(...)),
],
);
$this->plan = $__joinPoint->write($this, $value, $this->plan);
}
}
}
Аудит каждого изменения одним атрибутом
Отметьте важные свойства атрибутом #[Auditable]. Поведение аудита подключается к каждому из них как динамический middleware: каждая запись фиксируется с именем свойства, старым и новым значением, откуда бы она ни пришла.
- Каждая запись отмеченного свойства из любого кода: снаружи, внутри класса, в конструкторе
- Старое и новое значение — до того, как запись выполнится
- Неотмеченные свойства и чтения не стоят ничего лишнего
- Сущность сохраняет простые публичные свойства: без сеттеров, без __set()
#[\Attribute(\Attribute::TARGET_PROPERTY)]final class Auditable {}$customer->plan = 'pro'; // audit: plan, from "free" to "pro"$customer->upgrade('team'); // audit: plan, from "pro" to "team"$customer->displayName = 'Ann'; // no record: no #[Auditable]echo $customer->email; // reads pass through untouched
<?php
declare(strict_types=1);
namespace App\Entity;
use App\Attribute\Auditable;
class Customer
{
#[Auditable]
под аудитом
public string $email = '';
#[Auditable]
под аудитом
public string $plan = 'free';
public string $displayName = '';
без аудита
public function upgrade(string $plan): void
{
$this->plan = $plan;
}
}
<?php
namespace App\Aspect;
use Go\Aop\Aspect;
use Go\Aop\Intercept\FieldAccess;
use Go\Aop\Intercept\FieldAccessType;
use Go\Lang\Attribute\Around;
use Psr\Log\LoggerInterface;
final class AuditAspect implements Aspect
{
public function __construct(private LoggerInterface $audit) {}
#[Around('@access(App\Attribute\Auditable)')]
каждое свойство с #[Auditable]
public function auditWrite(FieldAccess $access): mixed
{
if ($access->getAccessType() === FieldAccessType::Write) {
только запись
$this->audit->info('Property changed', [
'property' => $access->getField()->name,
'from' => $access->getValue(),
'to' => $access->getValueToSet(),
]);
}
return $access->proceed();
значение записано
}
}
Достаточно быстро, чтобы не выключать
Измерения и полный список правил — в docs/advices.md и docs/performance.md.
- на обращение< 0.3 µsна чтение или запись свойства через его middleware
- магии0никаких __get и __set: IDE и PHPStan видят настоящие свойства
- нативноPHP 8.4встроено в собственные хуки свойств языка
Выберите свои свойства
Начните с pointcut (среза) @access(App\Attribute\Auditable) и измените его: каждое свойство, которое он выбирает, подсвечивается в песочнице, строка за строкой.
Проверить pointcutВсё остальное в комплекте
- Чистый PHPНикаких расширений. Никаких чёрных ящиков. Только PHP.
- Перехват чего угодноНет методов, закрытых для перехвата.
- ОтлаживаемостьНикакой магии, которую нельзя пройти по шагам.
- ПроизводительностьНоль затрат без поведений, меньше 1 мкс с ними.
- Язык срезовВыбирайте ровно тот код, который нужен, и проверяйте вживую.
- Расширения классовНовые интерфейсы и трейты для существующих классов.
- Работает с вашим стекомSymfony, Laravel, Yii3 и ваш ИИ-агент для разработки.