Eine Lupe zeigt eine cyanfarbene Struktur in gestapelten Glasschichten.
Funktion · Debugbar

Keine Magie, die Sie nicht Schritt für Schritt durchgehen können.

Generierter Code darf kein verstecktes Verhalten bedeuten. Das Framework erzeugt lesbares PHP, das Sie mit Ihren gewohnten Werkzeugen ansehen, diffen, debuggen und Schritt für Schritt durchgehen können.

Ihre Klasse, und was wirklich läuft

Ein Report-Service mit Caching-Verhalten und die zwei Dateien, die das Framework dafür schreibt. Es sind die echten Dateien aus der Session, die Sie unten Schritt für Schritt durchgehen können.

Ihr Quelltext

Ein Caching-Verhalten wird mit #[Cacheable] angehängt. Das ist die Datei, die Sie öffnen, lesen und mit Breakpoints versehen.

ReportService.phpIhr Code

        
        
        <?php
        
        
        
      
        
        
         
        
        
        
      
        
        
        declare(strict_types=1);
        
        
        
      
        
        
         
        
        
        
      
        
        
        namespace App\Report;
        
        
        
      
        
        
         
        
        
        
      
        
        
        use App\Attribute\Cacheable;
        
        
        
      
        
        
         
        
        
        
      
        
        
        class ReportService
        
        
        
      
        
        
        {
        
        
        
      
        
        
            public function __construct(private OrderRepository $orders) {}
        
        
        
      
        
        
         
        
        
        
      
        
        
            #[Cacheable(ttl: 300)]
        Caching-Verhalten angehängt
        
        
      
        
        
            public function monthlyRevenue(string $month): int
        
        
        
      
        
        
            {
        
        
        
      
        
        
                $total = 0;
        ein Breakpoint hier greift
        
        
      
        
        
                foreach ($this->orders->forMonth($month) as $order) {
        
        
        
      
        
        
                    $total += $order->cents;
        
        
        
      
        
        
                }
        
        
        
      
        
        
         
        
        
        
      
        
        
                return $total;
        
        
        
      
        
        
            }
        
        
        
      
        
        
        }
        
        
        
      

Kompilierter Quelltext

Ihr Klassenrumpf als Trait. Nur die Deklarationszeile ändert sich, jede Zeilennummer bleibt. Im Debug-Modus lädt PHP ihn unter Ihrem ursprünglichen Pfad, sodass der Debugger in src/Report/ReportService.php anhält.

ReportServiceOriginalTrait.phpkompiliert

        
        
        <?php
        
        
        
      
        
        
         
        
        
        
      
        
        
        declare(strict_types=1);
        
        
        
      
        
        
         
        
        
        
      
        
        
        namespace App\Report;
        
        
        
      
        
        
         
        
        
        
      
        
        
        use App\Attribute\Cacheable;
        
        
        
      
        
        
         
        
        
        
      
        
        
        trait ReportServiceOriginalTrait
        vorher: 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';
        
        
        
      

Proxy-Klasse

Die Klasse, die PHP lädt, mit Ihrem Klassennamen, sodass Stacktraces ReportService nennen. Die Middleware ist eine lesbare Methode: den Joinpoint einmal bauen, dann ausführen.

ReportService.phpgeneriert

        
        
        <?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
        Ihr Klassenname
        
        
      
        
        
        {
        
        
        
      
        
        
            use ReportServiceOriginalTrait {
        Ihr Klassenrumpf
        
        
      
        
        
                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(
        einmal gebaut, beim ersten Aufruf
        
        
      
        
        
                    self::class,
        
        
        
      
        
        
                    'monthlyRevenue',
        
        
        
      
        
        
                    [
        
        
        
      
        
        
                        Interceptor::around(The::aspect(CachingAspect::class)->cache(...)),
        Strg-Klick öffnet CachingAspect::cache()
        
        
      
        
        
                    ],
        
        
        
      
        
        
                    $this->monthlyRevenueOriginalAlias(...),
        Ihre ursprüngliche Methode
        
        
      
        
        
                );
        
        
        
      
        
        
                return $__joinPoint->__invoke($this, [$month]);
        führt die Middleware aus
        
        
      
        
        
            }
        
        
        
      
        
        
        }
        
        
        
      

Debuggen wie selbst geschriebenen Code

Eine echte Debugging-Session derselben Klasse, aufgezeichnet und in Ihrem Browser abgespielt. Springen Sie in den Aufruf, setzen Sie Breakpoints in der Leiste, öffnen Sie jeden Frame. Die Anleitung erklärt, was bei jedem Schritt passiert.

Debug: php bin/report.phpreplay
bin/report.php
<?php
declare(strict_types=1);
use App\Report\OrderRepository;
use App\Report\ReportService;
require dirname(__DIR__) . '/bootstrap.php';
$reports = new ReportService(new OrderRepository());
foreach (['2026-10', '2026-10'] as $month) {
$start = hrtime(true);
$cents = $reports->monthlyRevenue($month);
printf("%s: %d cents in %.2f ms\n", $month, $cents, (hrtime(true) - $start) / 1e6);
}

Frames

    Variables

    Console timed under the debugger

    stop 1 of 84

    Aus der Konsole

    Fragen Sie den Weaver, was er getan hat

    Die Konsole, die mit dem Framework kommt, beantwortet Fragen zu Ihrem Kernel: welche Verhaltensklassen er hat und was jede erreicht. Sie kompiliert auch den Cache im Voraus. Scrollen Sie durch die Befehle; das Terminal zeigt ihre echte Ausgabe für die App oben.

    1. Run the app

      php bin/report.php

      The 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.

    2. List the behavior classes

      vendor/bin/aspect debug:aspect bootstrap.php

      Every 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.

    3. List the advisors

      vendor/bin/aspect debug:advisor bootstrap.php

      Each advisor with its pointcut. Here there is one: cache(), for every method marked #[Cacheable].

    4. 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.

    5. Weave ahead of time

      vendor/bin/aspect cache:warmup:aop bootstrap.php

      Weaves every file at deploy time, so production serves the prebuilt cache. It fails when a file can’t be woven; --workers=8 weaves in parallel.

    Terminalrecorded
    php bin/report.php
    2026-10: 21199 cents in 156.16 ms
    2026-10: 21199 cents in 0.01 ms
    vendor/bin/aspect debug:aspect bootstrap.php
    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
     --------- ---------------------------------
    vendor/bin/aspect debug:advisor bootstrap.php
    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
    vendor/bin/aspect debug:advisor bootstrap.php --advisor='App\Aspect\CachingAspect->cache'
    Advisor debug information
    =========================
    
    Total 6 files to analyze.
      -> matching method App\Report\ReportService->monthlyRevenue
    vendor/bin/aspect cache:warmup:aop bootstrap.php
    Total 6 files to process.
    
    [DONE]: Total processed 6, 0 errors in 5 ms.

    Verhalten bauen. Alles debugbar halten.

    Die meisten Frameworks verlangen, dass Sie der Magie vertrauen. Hier können Sie jede Zeile, die läuft, öffnen, ansehen und Schritt für Schritt durchgehen.