PHPackages symplify/autodiscovery - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. symplify/autodiscovery Abandoned → [symfony/http-kernel](/?search=symfony%2Fhttp-kernel)Library[Database & ORM](/categories/database) symplify/autodiscovery ====================== Forget manual registration of Doctrine entities, Twig templates and routes. Let autodiscovery handle that for you. 9.0.34(5y ago)1046.3k↓75.6%MITPHPPHP >=7.3CI failing Since Dec 18Pushed 5y ago2 watchersCompare [ Source](https://github.com/deprecated-packages/autodiscovery)[ Packagist](https://packagist.org/packages/symplify/autodiscovery)[ Fund](https://www.paypal.me/rectorphp)[ GitHub Sponsors](https://github.com/tomasvotruba)[ RSS](/packages/symplify-autodiscovery/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependencies (20)Versions (232)Used By (0) Load Entities, Twig paths and Routes once and for All ===================================================== [](#load-entities-twig-paths-and-routes-once-and-for-all) [![Downloads total](https://camo.githubusercontent.com/e819ef166a504d86be9efd1f6d8d5b25f9fb34ea1cf71983255ba23ab6498d68/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73796d706c6966792f6175746f646973636f766572792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/symplify/autodiscovery/stats) For every - **new Entity namespace**, - **new Twig path** - **new Translation catalogue path** - and **new routes files**, you need to modify your config. Why do it, when your application can do it for you? Do you autoload each Controller manually? :) Another feature is YAML convertor - from old pre-Symfony 3.3 to new autodiscovery, autowire and autoconfigure format. Install ------- [](#install) ``` composer require symplify/autodiscovery ``` Usage ----- [](#usage) ### 1. Register Doctrine Annotation Mapping [](#1-register-doctrine-annotation-mapping) When you create a new package with entities, you need to register them: ``` # app/config/doctrine.yml doctrine: orm: mappings: # new set for each new namespace ShopsysFrameworkBundle: type: annotation dir: '%shopsys.framework.root_dir%/src/Model' alias: ShopsysFrameworkBundle prefix: Shopsys\FrameworkBundle\Model is_bundle: false # new set for each new namespace ShopsysFrameworkBundleComponent: type: annotation dir: '%shopsys.framework.root_dir%/src/Component' alias: ShopsysFrameworkBundleComponent prefix: Shopsys\FrameworkBundle\Component is_bundle: false ``` It's called [memory lock](https://www.tomasvotruba.com/blog/2018/08/27/why-and-how-to-avoid-the-memory-lock/) and it nicely opens doors for "I forgot that..." bugs. How can we avoid that? #### With Autodiscovery [](#with-autodiscovery) ``` # app/config/twig.yml doctrine: orm: - mappings: - # new set for each new namespace - ShopsysFrameworkBundle: - type: annotation - dir: '%shopsys.framework.root_dir%/src/Model' - alias: ShopsysFrameworkBundle - prefix: Shopsys\FrameworkBundle\Model - is_bundle: false - # new set for each new namespace - ShopsysFrameworkBundleComponent: - type: annotation - dir: '%shopsys.framework.root_dir%/src/Component' - alias: ShopsysFrameworkBundleComponent - prefix: Shopsys\FrameworkBundle\Component - is_bundle: false ``` ``` namespace App; use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait; use Symfony\Component\Config\Loader\LoaderInterface; use Symfony\Component\DependencyInjection\ContainerBuilder; use Symfony\Component\HttpKernel\Kernel; use Symplify\Autodiscovery\Discovery; final class MyProjectKernel extends Kernel { use MicroKernelTrait; /** * @var Discovery */ private $discovery; public function __construct() { parent::__construct('dev', true); $this->discovery = new Discovery($this->getProjectDir()); } protected function configureContainer(ContainerBuilder $containerBuilder, LoaderInterface $loader): void { $this->discovery->discoverEntityMappings($containerBuilder); } } ``` ### 2. Twig Paths [](#2-twig-paths) When you create a new package with templates, you need to register them: ``` # app/config/twig.yml twig: paths: # new line for each new package - "%kernel.root_dir%/../package/Product/templates" # new line for each new package - "%kernel.root_dir%/../package/Social/templates" ``` #### With Autodiscovery [](#with-autodiscovery-1) ``` # app/config/twig.yml twig: - paths: - - "%kernel.root_dir%/../package/Product/templates/views" - - "%kernel.root_dir%/../package/Social/templates/views" ``` ``` namespace App; use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait; use Symfony\Component\Config\Loader\LoaderInterface; use Symfony\Component\DependencyInjection\ContainerBuilder; use Symfony\Component\HttpKernel\Kernel; final class MyProjectKernel extends Kernel { use MicroKernelTrait; // ... protected function configureContainer(ContainerBuilder $containerBuilder, LoaderInterface $loader): void { $this->discovery->discoverTemplates($containerBuilder); } } ``` ### 3. Translation Paths [](#3-translation-paths) When you create a new package with translations, you need to register them: ``` # app/config/packages/framework.yml framework: translator: paths: # new line for each new package - "%kernel.root_dir%/../package/Product/translations" # new line for each new package - "%kernel.root_dir%/../package/Social/translations" ``` #### With Autodiscovery [](#with-autodiscovery-2) ``` # app/config/packages/framework.yml framework: translator: - paths: - - "%kernel.root_dir%/../package/Product/translations" - - "%kernel.root_dir%/../package/Social/translations" ``` ``` namespace App; use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait; use Symfony\Component\Config\Loader\LoaderInterface; use Symfony\Component\DependencyInjection\ContainerBuilder; use Symfony\Component\HttpKernel\Kernel; final class MyProjectKernel extends Kernel { use MicroKernelTrait; // ... protected function configureContainer(ContainerBuilder $containerBuilder, LoaderInterface $loader): void { $this->discovery->discoverTranslations($containerBuilder); } } ``` ### 4. Routing [](#4-routing) ``` # app/config/routes.yaml # new set for each new package product_annotations: resource: "../packages/Product/src/Controller/" type: "annotation" # new set for each new package social_annotations: resource: "../packages/Social/src/Controller/" type: "annotation" ``` #### With Autodiscovery [](#with-autodiscovery-3) ``` # app/config/routes.yaml -# new set for each new package -product_annotations: - resource: "../packages/Product/src/Controller/" - type: "annotation" - -# new set for each new package -social_annotations: - resource: "../packages/Social/src/Controller/" - type: "annotation" ``` ``` namespace App; use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait; use Symfony\Component\HttpKernel\Kernel; use Symfony\Component\Routing\RouteCollectionBuilder; final class MyProjectKernel extends Kernel { use MicroKernelTrait; protected function configureRoutes(RouteCollectionBuilder $routeCollectionBuilder): void { $this->discovery->discoverRoutes($routeCollectionBuilder); } } ``` This works very well with [local packages](https://www.tomasvotruba.com/blog/2017/12/25/composer-local-packages-for-dummies/) or [monorepo architecture](https://www.tomasvotruba.com/clusters/#monorepo-from-zero-to-hero). Report Issues ------------- [](#report-issues) In case you are experiencing a bug or want to request a new feature head over to the [Symplify monorepo issue tracker](https://github.com/symplify/symplify/issues) Contribute ---------- [](#contribute) The sources of this package are contained in the Symplify monorepo. We welcome contributions for this package on [symplify/symplify](https://github.com/symplify/symplify). ### Health Score 38 — LowBetter than 85% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community10 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 88.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 230 Last Release 1948d ago Major Versions v5.4.16 → v6.0.02019-05-28 v6.1.0 → v7.0.02019-11-23 v7.3.18 → v8.0.0-beta12020-05-16 8.3.48 → 9.0.0-BETA12020-11-14 PHP version history (5 changes)v5.2.18PHP ^7.1 v7.0.0PHP ^7.2 8.2.17PHP ^7.2|^8.0 8.3.0PHP >=7.2 9.0.0-rc1PHP >=7.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/924196?v=4)[Tomas Votruba](/maintainers/TomasVotruba)[@TomasVotruba](https://github.com/TomasVotruba) --- Top Contributors [![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (8 commits)")[![samsonasik](https://avatars.githubusercontent.com/u/459648?v=4)](https://github.com/samsonasik "samsonasik (1 commits)") --- Tags autodiscoverydoctrineservicessymfonytwigyaml ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/symplify-autodiscovery/health.svg) ``` [![Health](https://phpackages.com/badges/symplify-autodiscovery/health.svg)](https://phpackages.com/packages/symplify-autodiscovery) ``` ### Alternatives [symfony/framework-bundle Provides a tight integration between Symfony components and the Symfony full-stack framework 3.6k235.4M9.7k](/packages/symfony-framework-bundle)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[drupal/core Drupal is an open source content management platform powering millions of websites and applications. 19462.3M1.3k](/packages/drupal-core)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[ssch/typo3-rector Instant fixes for your TYPO3 PHP code by using Rector. 2592.8M263](/packages/ssch-typo3-rector) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)