Download the PHP package gatomontes/symfony-twig-route-tracer without Composer

Symfony Twig Route Tracer

A DX package for Symfony + Twig projects.

Installation

Problem

Twig to controller navigation in PhpStorm is painful.

This package injects non-rendering route traces into Twig templates so IDE route navigation can be reused.

Example:

The trace never executes at runtime.

Its purpose is IDE navigation.

Commands

Inject a single route:

Preview a route injection without writing files:

Inject all routes:

Injection Rules

• additive
• idempotent
• no duplicates
• alphabetically sorted
• validates generated Twig before writing
• supports --dry-run previews for safe review

MVP Notes

• route resolution uses Symfony router metadata
• template resolution scans controller source for $this->render('...')
• template resolution also follows renderView() calls and local service/document-builder methods that contain Twig template literals
• injected traces use native Twig path() calls so IDEs can reuse Symfony route recognition
• traces are wrapped in {% if false %} so routes with required params never execute at runtime
• namespaced Twig templates such as @Admin/foo.html.twig are not supported yet

Known Limitations

• template discovery is static and source-based; highly dynamic template selection may not be traced
• namespaced Twig template references such as @Admin/foo.html.twig are not resolved yet
• service traversal is limited to local project services and Twig template string literals

Goals

• Twig -> controller navigation
• leverage existing Symfony route intelligence
• avoid custom IDE plugins
• MakerBundle integration