Upgrading

Version-by-version upgrade notes for the Twig Inspector Bundle.

This page covers what changed between releases and any action you need to take. Most releases are fully backward-compatible — check the entry for your current version to confirm.

This bundle follows Semantic Versioning. Patch releases (1.0.x) contain bug fixes and are always backward-compatible. Minor releases (1.x.0) add features in a backward-compatible way. Major releases (x.0.0) may contain breaking changes.

General upgrade steps

1. Update the package

   composer update nowo-tech/twig-inspector-bundle
   
2. Clear the cache

   php bin/console cache:clear
   
3. Review your version's entry below

   Check the section for your previous version to see if any action is required.

---

1.0.24 → 1.0.25

No action required — backward-compatible release.

A new compiler pass (TwigPathsPass) registers the bundle’s views path with the native Twig loader. If you override bundle templates in templates/bundles/NowoTwigInspectorBundle/, they are now correctly consulted first — matching standard Symfony bundle override behaviour.

---

1.0.23 → 1.0.24

No action required — CI and test compatibility only. No configuration or API changes.

---

1.0.22 → 1.0.23

No action required — tests and coverage only. No configuration or API changes.

---

1.0.21 → 1.0.22

No action required — test robustness only. No configuration or API changes.

---

1.0.20 → 1.0.21

No action required — backward-compatible bug fix.

The InstallCommand help text was moved from the #[AsCommand] attribute to setHelp() in configure() for compatibility with Symfony Console 6.4 on PHP 8.1. The output of --help is unchanged.

---

1.0.19 → 1.0.20

No action required — backward-compatible bug fix.

The TwigInspectorCollector service definition was corrected to pass the right constructor arguments. If you decorated or overrode this service, verify your decoration matches the constructor signature (ControllerRenderSubscriber, ?Twig\Environment, ...config params). Standard installs are unaffected.

---

1.0.18 → 1.0.19

No action required — backward-compatible release.

Profiler serialization fixed so the DataCollector works after unserialize (relevant on PHP 8.5 and when loading profiles from storage). No configuration changes.

---

1.0.17 → 1.0.18

No action required — tooling and demos only.

If you rely on docker-compose.test.yml for running tests, switch to the main docker-compose.yml and the updated Makefile targets. No impact on bundle users.

---

1.0.16 → 1.0.17

No action required — backward-compatible release.

Defensive fix in the controller for non-string Twig namespace keys. Demo HTTP port changed from 443 to 80; rebuild images with make build if you run demos locally.

---

1.0.15 → 1.0.16

Action for contributors only — if you use the Makefile for asset builds, rename your commands.

Makefile asset targets were renamed:

Old name	New name
make build-assets	make assets
make build-assets-dev	make assets-dev
make watch-assets	make assets-watch
make clean-assets	make assets-clean

Bundle users who do not contribute to the repository are unaffected.

---

1.0.14 → 1.0.15

Action recommended — ensure your routes are restricted to dev and test.

If your config/routes.yaml imports Twig Inspector routes without when@dev: / when@test: guards, update it now. Routes must never be active in production.

Update config/routes.yaml to:

when@dev:
    nowo_twig_inspector:
        resource: '@NowoTwigInspectorBundle/Resources/config/routes.yaml'

when@test:
    nowo_twig_inspector:
        resource: '@NowoTwigInspectorBundle/Resources/config/routes.yaml'

The “open in IDE” controller now returns 404 in prod as a defence-in-depth measure even if routes are misconfigured. ChainLoader users gain support for multiple Twig template directories with no config changes.

---

1.0.13 → 1.0.14

No action required — backward-compatible release.

Internal service IDs for some bundle services now use FQCN. If you referenced any of these services by ID (for decoration), update the reference. The controller service nowo_twig_inspector.controller.open_template is unchanged.

---

1.0.12 → 1.0.13

No action required — documentation-only release. No code or configuration changes.

---

1.0.11 → 1.0.12

No action required — backward-compatible release.

New configuration option inject_on_sub_requests (default false). If all your templates show “sub-request” in the panel and none get inspected, set this to true:

nowo_twig_inspector:
    inject_on_sub_requests: true

The overlay is now off by default when the inspector is enabled. Click the </> toolbar icon to activate it.

---

1.0.10 → 1.0.11

No action required — backward-compatible release.

New Controllers tab in the profiler panel. Controller HTML comments are injected in the page source when the inspector is active. The Count column in Templates and Blocks tables was renamed to Renders. No configuration changes needed.

---

1.0.9 → 1.0.10

No action required — backward-compatible release.

New “How to use” tab in the profiler panel. Template filter now supports path matching and comma-separated terms. Template timing data now appears correctly when the Twig profiler extension is active.

---

1.0.8 → 1.0.9

No action required — backward-compatible fix.

If you see the deprecation warning NodeStart requires #[\Twig\Attribute\YieldReady] attribute, upgrade to 1.0.9 or later.

Added #[\Twig\Attribute\YieldReady] to NodeStart for Twig 4.0+ compatibility. No breaking changes; works with all supported Twig versions (3.8+).

---

1.0.7 → 1.0.8

No action required — Packagist metadata and documentation only.

---

1.0.6 → 1.0.7

No action required — backward-compatible fix.

If you see the deprecation warning Since twig/twig 3.15: Instantiating "Twig\Node\Node" directly is deprecated, upgrade to 1.0.7 or later.

Replaced direct Twig\Node\Node instantiation with BodyNode in DebugInfoNodeVisitor for compatibility with Twig 3.15+.

---

1.0.5 → 1.0.6

No action required — documentation update. Minimum code coverage requirement adjusted from 100% to 97.5% to reflect realistic testing limits for edge cases.

---

1.0.4 → 1.0.5

No action required — backward-compatible bug fix.

Wildcard pattern matching in excluded_templates and excluded_blocks was fixed. Patterns like admin/* and email/*.html.twig now work correctly.

---

1.0.3 → 1.0.4

No action required — backward-compatible bug fix.

The route pattern now allows slashes in template names so templates in subdirectories (e.g. admin/users/list.html.twig) work correctly with the “open in IDE” link.

---

1.0.2 → 1.0.3

No action required — routes are now configured automatically.

The InstallCommand and Flex Recipe now create and update config/routes.yaml automatically. If you previously added the routes manually, the bundle detects this and does not duplicate the import.

If you still prefer to configure routes manually:

when@dev:
    nowo_twig_inspector:
        resource: '@NowoTwigInspectorBundle/Resources/config/routes.yaml'

---

1.0.1 → 1.0.2

No action required — backward-compatible CI/CD and compatibility fixes.

PHP/Symfony matrix fixes, PHPUnit constraint for PHP 8.1, PHP-CS-Fixer updates. No configuration or API changes.

---

1.0.0 → 1.0.1

No action required — first stable release.

If upgrading from a pre-release version, verify your environment meets the minimum requirements:

Dependency	Minimum version
PHP	8.1
Symfony	6.0
Twig	3.8
Symfony Web Profiler Bundle	6.0

---

Version requirements

Dependency	Supported range
PHP	>= 8.1, < 8.6
Symfony	6.x, 7.x, 8.x
Twig	>= 3.8, 4.x
Symfony Web Profiler	6.x, 7.x, 8.x

Getting help

If you encounter issues during an upgrade:

1. Check the changelog for detailed changes between releases.
2. Review the configuration options if behaviour changed.
3. Open an issue on GitHub.