Меняет то, что происходит при выполнении существующего кода.
#[Around('@execution(App\Attribute\Cacheable)')]Метод сохраняет сигнатуру. Вокруг каждого вызова выполняется поведение: кеширование, логирование, транзакции.
Перехват чего угодно
Добавляйте интерфейсы и трейты существующим классам, не изменяя их исходный код и не выстраивая иерархии наследования.
Добавьте интерфейс и его реализацию каждому классу, который выбирает pointcut (срез), — из одного места.
Добавьте для DTO или модели стороннего пакета ваш собственный интерфейс из приложения и переиспользуемый трейт — без форка.
Посмотреть примерПерехват меняет то, что происходит при выполнении кода. Introduction (внедрение) меняет то, что умеет класс: его интерфейсы и методы.
СравнитьКак объявляются introductions и как они сочетаются с другими поведениями того же класса.
Читать документациюОба объявляются в классе поведений (в API — aspect, аспект), и оба не трогают ваши исходные файлы.
#[Around('@execution(App\Attribute\Cacheable)')]Метод сохраняет сигнатуру. Вокруг каждого вызова выполняется поведение: кеширование, логирование, транзакции.
Перехват чего угодно#[DeclareParents('within(Acme\Payments\Dto\*)', …)]Класс получает интерфейс и методы трейта. Вокруг существующих вызовов ничего не выполняется: ваш код вызывает новые методы.
Посмотреть примерВаш конвейер экспорта принимает всё, что реализует Exportable. DTO платёжного SDK его не реализуют, к тому же они final. Вместо того чтобы форкать пакет или оборачивать каждый DTO в адаптер, один класс поведений добавляет им всем ваш интерфейс и переиспользуемый трейт.
interface Exportable{ /** @return array<string, scalar|null> */ public function toExportRow(): array;} // src/Export/ExportsPublicProperties.phptrait ExportsPublicProperties{ public function toExportRow(): array { return get_object_vars($this); }}Укажите пакет в includePaths, чтобы он компилировался как ваш собственный код. Компиляция vendor-кода удлиняет прогрев, поэтому перечисляйте только те пакеты, которые расширяете.
AppKernel::getInstance()->init([ // … 'includePaths' => [ __DIR__ . '/src', __DIR__ . '/vendor/acme/payments-sdk/src', ],]);$charge = new Charge('ch_1', 4200, 'EUR'); // a vendor DTO $charge instanceof Exportable; // true$exporter->write($charge); // accepts any Exportable$charge->toExportRow(); // ['id' => 'ch_1', 'amount' => 4200, 'currency' => 'EUR']
<?php
declare(strict_types=1);
namespace Acme\Payments\Dto;
final readonly class Charge
final и readonly
{
public function __construct(
public string $id,
public int $amount,
public string $currency,
) {}
}
<?php
declare(strict_types=1);
namespace App\Aspect;
use App\Contract\Exportable;
use App\Export\ExportsPublicProperties;
use Go\Aop\Aspect;
use Go\Lang\Attribute\DeclareParents;
final class ExportAspect implements Aspect
{
#[DeclareParents('within(Acme\Payments\Dto\*)', interfaceName: Exportable::class, traitName: ExportsPublicProperties::class)]
каждый DTO пакета
protected null $exportable;
}
<?php
declare(strict_types=1);
namespace Acme\Payments\Dto;
use Go\Aop\Framework\InterceptorInjector;
use Go\Aop\Framework\Interceptor;
use Go\Aop\Framework\The;
final readonly class Charge implements \App\Contract\Exportable, \Go\Aop\Proxy
ваш интерфейс
{
use ChargeOriginalTrait, \App\Export\ExportsPublicProperties;
ваш трейт
}
Подробнее — в docs/advices.md и docs/configuration.md.
Пакет остаётся таким, каким его установил Composer. Обновления по-прежнему приходят через composer update, а следующий прогрев кеша снова их компилирует.
Класс сохраняет имя, модификаторы и родителей. Интерфейс и трейт добавляются ему самому, а не подклассу.
instanceof и объявления типов работают, потому что класс, который загружает PHP, действительно его реализует.