symfony-bundle dev-bundle

steevanb/dev-bundle

Throws exception on translation not found and invalid doctrine schema.

, _(*1)

dev-bundle

Bundle for dev environment, to help you find missing translations, validate your Doctrine schema automatically and show what is loaded (classes, services etc)., _(*2)

For Symfony ^2.6 and ^3.0, see steevan/dev-bundle ^4.1., _(*3)

Changelog, _(*4)

Installation

composer require steevanb/dev-bundle ^5.0.1

Or add it manually, and then execute composer update steevanb/dev-bundle :, _(*5)

# composer.json
{
    "require": {
        "steevanb/dev-bundle": "^5.0.1"
    }
}

Add bundle to your AppKernel :, _(*6)

# app/AppKernel.php
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        if ($this->getEnvironment() == 'dev') {
            $bundles[] = new steevanb\DevBundle\DevBundle();
        }
    }
}

Configuration

# app/config/config.yml
dev:
    # throws steevanb\DevBundle\Exception\TranslationsNotFoundException on translations not found
    translation_not_found:
        enabled: [TRUE|false]
        # allow Translator to search your translation in fallbacks, or not
        allow_fallbacks: [true|FALSE]
    # validate Doctrine schema
    validate_schema:
        enabled: [TRUE|false]
        disabled_urls:
            - /_wdt
            - /_profiler/
            - /_errors
        event: [KERNEL.REQUEST|kernel.response]
        excludes:
            - Foo\Bar\Entity
            - Foo\Bar\Entity#property
        bundles:
            # enable scan of Resources/config/doctrine dir of bundles
            enabled: [TRUE|false]
            # bundles to scan. if empty or not specified, will add all installed bundles
            bundles:
                - FooBundle
                - BarBundle

Translation not found exception

Throws steevanb\Exception\TranslationsNotFoundException at kernel.response event when at least one translation is not found., _(*7)

All translations not found throws this exception, especially when fallbacks are used., _(*8)

For example, if you have a messages.fr.yml in your bundle, and you try to translate a string with fr_FR locale, exception will be throwned. You can allow this with translation.allow_fallbacks configuration., _(*9)

Validate Doctrine mapping

Same as calling doctrine:schema:validate on each request, with a cache to not recall it if nothing has changed., _(*10)

Throws steevanb\Exception\InvalidMappingException when mapping informations are invalid., _(*11)

Doctrine schema validation will be executed on each request (_kernel.request_ or kernel.response event, depends on configuration), only for main request., _(*12)

You can exclude entities or properties validation, by adding values in dev.validate_schema.excludes configuration., _(*13)

If value is a fully classified entity, all validation errors on this entity will be ignored., _(*14)

If value if a fully qualifier entity, plus a property (ex : Foo\Bar\Entity#property), only validation errors on this property will be ignored., _(*15)

List loaded classes, services etc

Add Symfony WebProfilter panel, with informations about what is loaded : classes, traits, interfaces, services, container parameters, etc., _(*16)

, _(*17)