nowo-tech / seo-kit-bundle

v1.10.2 2026-09-27 16:25 UTC

Requires

• php: >=8.2 <8.6
• nowo-tech/form-kit-bundle: ^2.4
• symfony/config: ^7.0 || ^8.0
• symfony/dependency-injection: ^7.0 || ^8.0
• symfony/form: ^7.4 || ^8.0
• symfony/framework-bundle: ^7.0 || ^8.0
• symfony/http-foundation: ^7.0 || ^8.0
• symfony/http-kernel: ^7.0 || ^8.0
• symfony/routing: ^7.0 || ^8.0
• symfony/translation: ^7.4 || ^8.0
• symfony/twig-bundle: ^7.0 || ^8.0
• symfony/validator: ^7.4 || ^8.0
• symfony/yaml: ^7.0 || ^8.0
• twig/extra-bundle: ^3.12
• twig/string-extra: ^3.12
• twig/twig: ^3.8

Requires (Dev)

• doctrine/doctrine-bundle: ^2.13 || ^3.0
• doctrine/orm: ^3.0
• friendsofphp/php-cs-fixer: ^3.0
• igor-php/igor-php: ^0.9.7
• nowo-tech/phpstan-frankenphp: ^1.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^10.0
• rector/rector: ^2.0
• symfony/browser-kit: ^7.0 || ^8.0
• symfony/cache: ^7.0 || ^8.0
• symfony/console: ^7.0 || ^8.0
• symfony/phpunit-bridge: ^7.0 || ^8.0
• symfony/security-bundle: ^7.0 || ^8.0
• vincentlanglet/twig-cs-fixer: ^4.0

Suggests

• doctrine/doctrine-bundle: Registers ORM mappings when persistence is enabled
• doctrine/orm: Required when nowo_seo_kit.persistence.enabled is true (SeoSiteSettings / SeoSurface)
• symfony/cache: Optional cache.app for SeoSiteConfigProvider snapshots
• symfony/console: Required for nowo:seo:audit
• symfony/flex: For automatic recipe installation (config and bundles.php)
• symfony/security-bundle: Access control on admin controllers

MIT

• Héctor Franco Aceituno
• Nowo.tech

• symfony
• i18n
• bundle
• Sitemap
• seo
• robots
• meta
• open-graph
• nginx
• twitter-cards
• hreflang
• frankenphp

Published on Packagist.org on 2026-09-27 16:39 UTC

README

⭐ Found this useful? Give it a star on GitHub! It helps us maintain and improve the project.

Symfony SEO kit: multilingual static routes, slug SEO layers (defaults / pages / slug patterns / specific slugs), head tags, hreflang, sitemap and robots for FrankenPHP, php-fpm and Nginx.

This bundle is FrankenPHP worker mode friendly.

Table of contents

• Features
• Installation
• Requirements
• Documentation
  • Additional documentation
• Version information
• Demos
• Tests and coverage
• License

Features

• ✅ Hierarchical SEO config — defaults → slug_routes → pages → slugs → attribute → runtime
• ✅ Twig head helper — {{ nowo_seo_head() }} with Open Graph, Twitter, JSON-LD, canonical, hreflang
• ✅ Multilingual paths — locale-specific paths and translated slugs
• ✅ Sitemap & robots — /sitemap.xml and /robots.txt served by Symfony
• ✅ Runtime overrides — SeoRuntime for dynamic titles from controllers
• ✅ Host providers — defaults, indexability, and sitemap URL extension points
• ✅ Optional Doctrine site settings — persistence.enabled + SeoSiteConfig snapshot
• ✅ Typed JSON-LD + audit CLI — structured data nodes and nowo:seo:audit
• ✅ Optional SEO admin + pencil API — site settings, surface overrides, FormKit forms, OriginUrlGuard
• ✅ Surface helpers — SeoSurfaceKeys + SeoSurfaceManager for CMS/blog pencils
• ✅ AbsoluteUrlBuilder — origin + path normalisation from base_url
• ✅ PHP 8 attribute — #[Seo] on controllers
• ✅ FrankenPHP-ready demo — single-container Symfony 8 demo

FrankenPHP: Demos use a single PHP service (FrankenPHP, no nginx). With APP_ENV=dev (default), the Docker entrypoint swaps in Caddyfile.dev — php_server without workers for comfortable local development. The baked-in production Caddyfile can use php_server { worker … }; see docs/DEMO-FRANKENPHP.md. Access the demo at http://localhost:PORT (see demo/README.md and .env.example).

Installation

composer require nowo-tech/seo-kit-bundle

Register the bundle in config/bundles.php (Flex does this automatically):

Nowo\SeoKitBundle\SeoKitBundle::class => ['all' => true],

Add to your base layout:

{{ nowo_seo_head() }}

Requirements

• PHP >= 8.2, < 8.6
• Symfony 7.4+ or 8.x (FormKit / form stack; other components still declare ^7.0 || ^8.0)
• nowo-tech/form-kit-bundle ^2.4 (hard dependency)

Documentation

• Installation
• Configuration
• PSR evaluation (REQ-CS-007)
• Usage
• Contributing
• Code of Conduct
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development
• GitHub Spec Kit

Additional documentation

• Demo with FrankenPHP (includes worker mode)
• FrankenPHP worker audit (kernel not reset between requests)
• Server cookbook (Nginx, php-fpm, FrankenPHP)
• GitHub Actions CI requirements

Version information

Version	PHP	Symfony	Status
1.10.x	>= 8.2	7.4 – 8.1+	Stable
1.9.x	>= 8.2	7.4 – 8.1+	Stable
1.8.x	>= 8.2	7.0 – 8.1+	Stable
1.7.x	>= 8.2	7.0 – 8.1+	Stable
1.6.x	>= 8.2	7.0 – 8.1+	Stable
1.5.x	>= 8.2	7.0 – 8.1+	Stable
1.4.x	>= 8.2	7.0 – 8.1+	Stable
1.3.x	>= 8.2	7.0 – 8.1+	Stable
1.2.x	>= 8.2	7.0 – 8.1+	Stable
1.1.x	>= 8.2	7.0 – 8.1+	Stable
1.0.x	>= 8.2	7.0 – 8.1+	Stable

Demos

make -C demo up-symfony8   # http://localhost:8050 (default PORT)

Demo extras: locale switch, / default-locale home, SEO Admin at /admin/seo. See docs/DEMO-FRANKENPHP.md.

Tests and coverage

make test
make test-coverage

• Tests: PHPUnit (unit)
• PHP: 100% lines (make test-coverage)

License

MIT — see LICENSE.