2017 © Pedro Peláez
 

library symfony-bundle-dependencies

Dependencies resolver for Symfony Bundles

image

mmoreram/symfony-bundle-dependencies

Dependencies resolver for Symfony Bundles

  • Friday, May 11, 2018
  • by mmoreram
  • Repository
  • 3 Watchers
  • 42 Stars
  • 32,264 Installations
  • PHP
  • 54 Dependents
  • 0 Suggesters
  • 3 Forks
  • 3 Open issues
  • 6 Versions
  • 20 % Grown

The README.md

Symfony Bundle Dependencies

Build Status, (*1)

The minimum requirements of this bundle is PHP 7.1 and Symfony 3.2 because the bundle is using features on both versions. If you're not using them yet, I encourage you to do it., (*2)

This package provides a very simple way of adding dependencies between Symfony Bundles. Composer defines these definitions in a very soft layer, only downloading these dependent packages. Bundles should as well force other Bundles to be instanced in the application to comply with Dependency Injection dependencies., (*3)

For your Bundle

If you want your bundles to provide this feature, then is as simple as make your bundles implement an interface. That simple., (*4)

Take in account that this addition will only provide compatibility with projects using this project, and will not affect anyway projects not using it., (*5)

``` php use Symfony\Component\HttpKernel\Bundle\Bundle; use Mmoreram\SymfonyBundleDependencies\DependentBundleInterface;, (*6)

/** * My Bundle */ class MyBundle extends Bundle implements DependentBundleInterface { /** * Create instance of current bundle, and return dependent bundle namespaces * * @return array Bundle instances */ public static function getBundleDependencies(KernelInterface $kernel) { return [ 'Another\Bundle\AnotherBundle', 'My\Great\Bundle\MyGreatBundle', // ... ]; } }, (*7)


Maybe one of your bundle dependencies need an specific value in the constructor. Well, this is a very very weird case, and you should definitely avoid it, but you can do it by adding the instance instead of the namespace. ``` php use Symfony\Component\HttpKernel\Bundle\Bundle; use Mmoreram\SymfonyBundleDependencies\DependentBundleInterface; /** * My Bundle */ class MyBundle extends Bundle implements DependentBundleInterface { /** * Create instance of current bundle, and return dependent bundle namespaces * * @return array Bundle instances */ public static function getBundleDependencies(KernelInterface $kernel) { return [ 'Another\Bundle\AnotherBundle', 'My\Great\Bundle\MyGreatBundle', new \Even\Another\Bundle\EvenAnotherBundle('some-value'), ]; } }

By default, all bundles defined as their namespace are instanced with the kernel object as first parameter, so doing something like that doesn't really have sense at all., (*8)

``` php use Mmoreram\SymfonyBundleDependencies\DependentBundleInterface;, (*9)

/** * My Bundle */ class MyBundle implements DependentBundleInterface { /** * Create instance of current bundle, and return dependent bundle namespaces * * @return array Bundle instances */ public static function getBundleDependencies(KernelInterface $kernel) { return [ new \Even\Another\Bundle\EvenAnotherBundle($this), ]; } }, (*10)


As you will see later, using instances instead of names will remove the possibility of using cache in the final project. ## For your Kernel In your project, you should be able to resolve all these dependencies. This is why this package offers you as well a way of doing that in your kernel. ``` php use Symfony\Component\HttpKernel\Kernel; use Mmoreram\SymfonyBundleDependencies\BundleDependenciesResolver; /** * Class AppKernel */ class AppKernel extends Kernel { use BundleDependenciesResolver; /** * Register application bundles * * @return array Array of bundles instances */ public function registerBundles() { return $this->getBundleInstances([ '\My\Bundle\MyBundle', ]); } }

In that case, you can pass as well instances of bundles instead of strings., (*11)

``` php use Symfony\Component\HttpKernel\Kernel; use Mmoreram\SymfonyBundleDependencies\BundleDependenciesResolver;, (*12)

/** * Class AppKernel */ class AppKernel extends Kernel { use BundleDependenciesResolver;, (*13)

/**
 * Register application bundles
 *
 * @return array Array of bundles instances
 */
public function registerBundles()
{
    return $this->getBundleInstances([
        new \My\Bundle\MyBundle($this),
    ]);
}

}, (*14)


## Performance As you may see, resolving dependencies can penalize a lot your website performance. Each time your Kernel is booted, all dependencies are resolved once and again, and this has no sense at all. This package offers you as well a cache layer, reducing to 0 from the second time your Kernel is booted and until your next deployment (cache file is stored in Kernel cache folder). One simple change to your code. That easy. ``` php use Mmoreram\SymfonyBundleDependencies\CachedBundleDependenciesResolver; /** * Class AppKernel */ class AppKernel { use CachedBundleDependenciesResolver; /** * Register application bundles * * @return array Array of bundles instances */ public function registerBundles() { return $this->getBundleInstances([ '\My\Bundle\MyBundle', ]); } }

Caching your bundle dependencies resolution can only be used when all dependencies are defined as strings instead of instances., (*15)

This library assumes that, as soon as something changes in your project that can change the dependencies file, you will remove cache. Just take it in account., (*16)

The order

Of course, the order matters. If two of your dependencies instantiate the same bundle with different parameters, then the first one to be defined will be the winner. In that case, if you want to explicitly define how a bundle must be instantiated even if other dependencies do, add this bundle at the beginning of your array., (*17)

``` php use Symfony\Component\HttpKernel\Kernel; use Mmoreram\SymfonyBundleDependencies\BundleDependenciesResolver;, (*18)

/** * Class AppKernel */ class AppKernel extends Kernel { use BundleDependenciesResolver;, (*19)

/**
 * Register application bundles
 *
 * @return array Array of bundles instances
 */
public function registerBundles()
{
    return $this->getBundleInstances([
        new \My\Bundle\MyBundle($this, true),
        'Another\Bundle\AnotherBundle',
        'My\Great\Bundle\MyGreatBundle',
    ]);
}

} ```, (*20)

This is also applied when defining the bundle dependencies., (*21)

The Versions

11/05 2018

dev-master

9999999-dev

Dependencies resolver for Symfony Bundles

  Sources   Download

MIT

The Requires

 

The Development Requires

bundle symfony dependencies

11/05 2018

v2.1.0

2.1.0.0

Dependencies resolver for Symfony Bundles

  Sources   Download

MIT

The Requires

 

The Development Requires

bundle symfony dependencies

27/12 2016

v2.0.0

2.0.0.0

Dependencies resolver for Symfony Bundles

  Sources   Download

MIT

The Requires

 

The Development Requires

bundle symfony dependencies

10/12 2015

v1.1.1

1.1.1.0

Dependencies resolver for Symfony Bundles

  Sources   Download

MIT

The Requires

 

The Development Requires

bundle symfony dependencies

10/12 2015

v1.1.0

1.1.0.0

Dependencies resolver for Symfony Bundles

  Sources   Download

MIT

The Requires

 

The Development Requires

bundle symfony dependencies

23/11 2015

v1.0.0

1.0.0.0

Dependencies resolver for Symfony Bundles

  Sources   Download

MIT

The Requires

 

The Development Requires

bundle symfony dependencies